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1 INTRODUCTION 

Digital Equipment Corporation has traditionally been a pioneer in 
developing and implementing standards for terminal service 
interfaces. The VTIOO was Digital's first terminal based on the 
ANSI standard for control sequence encoding (ANSI X3.64). Many of 
Digital's printer and display terminals have since implemented 
ANSI and DEC-private controls, and Digital has been an active 
participant in the development of new controls. The development 
of ReGIS (Remote Graphics Instruction Set) has enabled the 
corporation to implement a variety of graphics terminal products, 
and establish Digital as a force in the graphics terminal marlcet. 

Digital has built a number of terminals based on these interfaces, 
and has committed that future terminal products will continue to 
support these interfaces to ensure software compatibility for 
operating systems as well as application programs. It is expected 
that computing terminals and workstations will also emulate these 
interfaces in order to take advantage of the large body of 
software that already exists for these devices. 

The DEC STD 070 Video Systems Reference Manual (or Video SRM) 
documents the interfaces to Digital video terminal products. It 
is intended to serve as both an implementation specification for 
product developers, and as a guide to programmers attempting to 
produce software that is transportable across a wide range of 
devices. It defines the interfaces in a manner that is 
independent of the physical characteristics of a particular device 
implementation. Enough flexibility is allowed in the interface 
description to permit a wide variety of terminal products to be 
produced, while ensuring that software can be designed that can 
intelligently make use of the full range of features in a given 
product. 

As new functions are developed for new terminal products, they 
will be added to the Video SRM before final implementation. 
Furthermore, an architectural certification process provides a 
means of measuring product performance against the Video SRM, and 
ensures software compatibility across products. 

Products claiming conformance to the architectural specifications 
contained in the Video SRM must be submitted for certification 
testing and evaluated against the requirements of these standards. 
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2 AUDIENCE 

There are two intended audiences for the Video SRM. One is the 
engineers who design the hardware and firmware for future terminal 
products. It is important that these designers have a thorough 
knowledge of the functionality required at the device interface in 
order to build devices at a reasonable cost that will be interface 
compatible with existing software products. The Video SRM 
provides a detailed description of the logic required to implement 
these interfaces, and thus guarantees that gratuitous changes will 
not be introduced. 

The second audience for the Video SRM is the software engineers 
who design programs that use terminals to implement their user 
interfaces. The Video SRM provides these programmers with a 
convenient single source of information regarding Digital's family 
of terminals and workstation products. This document enables 
those engineers to produce device-independent software without the 
need to consult a proliferation of user's manuals and understand 
the discrepancies between implementations. 

The greatest benefit of this document is to the Digital customer. 
By providing a single point of reference between hardware and 
software components designed by the corporation. Digital 
significantly reduces consternation and confusion among field 
sales and service personnel and satisfies the marketplace that 
Digital provides system components that are designed to work 
together. 


3 RESPONSIBILITY 

Development and maintenance of the DEC STD 070 Video Systems 
Reference Manual is the responsibility of the Terminals 
Architecture Group, reporting to the Technical Director of the 
I Desktop Systems Group (DSG). Distribution and control of the 
I document is handled through the Standards and Methods Control 
I group of International Standards, Information, and Services 
I (ISIS). 

Section 1 delineates general architectural concepts and 
conformance certification criteria applicable to these 
requirements. 
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4 GENERAL TERMINOLOGY 

The following terminology is used throughout this document and 
applies across each section. 

coding interface - A software or hardware interface through which 
bytes of character-coded information are passed between terminal 
equipment and an application process across a host port, or 
between terminal equipment and a printer across a printer port. 

external interface - Product interfaces between a terminal, 
personal computer, or workstation, and a remote system. 

Host Port - The coding interface between a terminal or terminal 
process and an application process, whether the application 
process is running inside the terminal or in a host computer. 

internal interface - Product interfaces between a terminal 
sub-system and software processes running within a terminal, 
personal computer, or workstation. 

Printer Port - The coding interface between a terminal or terminal 
process and a printer. 

receive - To accept coded character information across a coding 
interface . - 

service class - A set of functionally related terminal control 
operations, associated by a common object type. 

transmit - To transfer coded character information across a coding 
interface . 

user; terminal user - A person operating a terminal device for the 
purpose of interacting with some component of a computer system or 
network . 
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I The following Table of Contents presents an outline of this manual 
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1.1 INTRODUCTION 

The Video Systems Reference Manual (or Video SRM) documents the 
interfaces to DEC video terminal products. It is intended to 
serve as both an implementation specification for product 
developers, as well as a guide- to programmers attempting to 
produce software which will be transportable across a wide range 
of devices. It defines the interfaces in a manner which is 
independent of the physical characteristics of a particular device 
implementation. Enough flexibility is allowed in the interface 
description to permit a wide variety of terminal products to be 
produced, while insuring that software can be designed that can 
intelligently make use of the full range of features in a given 
product. 

As new functionality is developed for new terminal products, it 
will be added to the Video SRM before final implementation. 
Furthermore, an architectural certification process provides a 
means of measuring product performance against the Video SRM, and 
ensures software compatibility across products. 

Products claiming conformance must be submitted for certification 
testing and evaluated against these standards. 


1.2 STRUCTURE OF THE MANUAL 

Terminal technology has become increasingly complex as the 
emphasis in computer system design has shifted from performing 
mathematical and scientific calculations to making information 
services readily accessible to the public. Even so-called "dumb 
terminals" of today incorporate a wide range of capabilities that 
bridge all aspects of computer architecture and design. In order 
to reduce this complexity to a state which is comprehensible to 
those who are not intimately familiar with these technologies, 
this manual has been broken up into sections which describe 
different functional components of a typical terminal system. 
Although there is some interaction between these components, they 
are described in such a way that they can more or less stand 
alone. 

The sections of this manual include descriptions of the following 
components; 


o Code Extension Layer - defines 7 and 8 bit character 
processing; defines escape and control sequence parsing; 
defines compatibility with DEC STD 169 for hardware, 
including graphic code extension techniques. 
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o Terminal Management - defines basic device independent 
terminal management functions. 

o Character Cell Display - defines Level 1 and Level 2 
operation for character cell display devices. 

o Keyboard Processing - defines use of the LK201 keyboard 
in terminals. 

o Printer Port - defines the display terminal to printer 
interface. 

o ReGIS Graphics - defines descriptor graphics protocol for 
Base ReGIS and Raster Extensions. 

o Sixel Graphics - defines serial protocol for image 
transfer. 

o Dynamically Redefinable Character Sets - defines loading 
and designation of Dynamically Redefinable Character Sets 
("soft" character sets). 

o User Definable Keys - defines loading and invocation of 
User Definable Keys (programmable function keys). 



Page 1-7 


VSRM Concepts and Conformance Criteria EL-00070-01 
*** COMPANY CONF - DEC Internal Use Only 15-May-1983 


These components have the following functional relationship in the 
design of an actual terminal product; 


Components of a Terminal System 
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1.3 ARCHITECTURAL STRUCTURE 

Terminals are an important part of any communications scheme. The 
earliest computer communications was performed using coded 
character sets and control functions. This document describes in 
detail some portions of an architectural model which • provides a 
consistent and uniform basis for the development of terminal 
service interfaces. 


1.3.1 Virtual Terminals 

The architectural model is built around the concept of 'Virtual 
Terminals', which virtualize the interface to real physical 
terminals. "A virtual terminal is a‘ model which defines an 
abstract terminal in terms of logical functions that can be 
implemented differently on different real terminals; therefore a 
virtual terminal consists of a real terminal and a protocol 
adaptor." (Electrical Communication, Vol . 56, No. 1, 1981). The 
virtual terminal interface consists of a number of disparate 
service classes, or sets of functions. 


1.3.2 Layers 

The architecture is layered in an attempt to group those sets of 
functions together which perform similar services within the 
communications structure. 


The architecture is broken down broadly into three functional 
layers. These layers are referred to as the Code Extension layer, 
the Presentation Service Class layer,- and the Input Processing 
layer. In addition, there is a set of management functions which 
operate across layers. 


Terminal 

Management 


Input Processing 
Presentation Service Class 
Code Extension Layer 


The purpose of layering the architecture is to separate components 
which are logically distinct, allowing components in one layer to 
be modified or replaced without impacting components in the other 
layers of the architecture. For example, the incorporation of a 
new keyboard interface would not necessarily affect the 
presentation protocol, or the syntax of the communications 
interchange. 
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1.3. 2.1 Code Extension Layer - 

The lowest layer of the architecture is referred to as the Code 
Extension Layer. This layer includes all services which form a 
part of the interface into the communications environment, as well 
as the syntax, or coding, of data and control functions. 

Since all of the existing terminal services use character coded 
data and controls (referred to as "ASCII stream"), this layer 
currently includes the following functions: 

o Communications Controls (such as XON/XOFF 

synchronization, padding, etc.) 

o ANSI Parsing (separation of controls and data) 

o Graphic Character Coding (7-bit and 8-bit environments) 


In the future this layer may be extended or replaced with other 
interfaces into DECnet, ISDN, X.25, etc., without affecting the 
overall structure of the architecture. 


1.3. 2. 2 Presentation Service Class - 

The next layer is referred to as the Presentation Service Class 
Layer. This layer includes' all services which directly provide 
imaging information. Output to the terminal is presented in the 
form of data types, whose structure and operations are unique to 
each service class definition. The only service class currently 
defined for this layer is the Character Cell Display. Future 
architectural development may include the definition of the 
following service classes: 

o Character Cell Printer 

o Proportionally Spaced Printer 

o Videotex 

o Image Transfer 


o 


Voice 



VSRM Concepts and Conformance Criteria EL- 00070 -01 
*** COMPANY CONF - DEC Internal Use Only 15 -May- 1983 


Page 1-10 


1.3. 2. 3 Input Processing - 

The upper layer of the architecture is referred to as the Input 
Processing Layer. This layer includes all services which relate 
to the processing of data entered into the terminal by the 
terminal user. Currently the only such device is the corporate 
standard keyboard, but this may be extended in the future to 
include other entry devices (such as voice input, mice, 
digitizers, etc.). 

This layer also may be extended to include local processing 
functions such as editing of text and graphics. It should be 
noted that the services provided at this layer may utilize the 
various services of the Presentation Service Class Layer in order 
to execute the functions they provide. For example, .a field 
editor might use ANSI text, ReGIS text. Videotex text, Teletex 
text (or even voice I/O) to perform the same requirements of 
processing field input. 


1.3. 2. 4 Terminal Management - 

Terminal Management functions operate across the other layers of 
the architecture. These functions include all services which 
provide for identification, negotiation, and management of device 
resources. Examples of these services include Device Attributes 
(DA), Soft Terminal Reset (DECSTR), and other control functions 
which affect the .physical state of the terminal device. In the 
future this layer may include multiplexing of virtual terminal 
connections (Virtual Terminal Management), service class 
selection, and window management (multiple display windows). 


1.3.3 Service Classes 

Within each layer of the architecture there may be classes of 
service. Functions within a layer are grouped into classes 
according to their logical relationship. For example, character 
oriented text displays might form a service class at the 
presentation layer which is distinct from a graphics protocol 
using logical pixel addressing. Furthermore, character oriented 
keyboard processing would form a class at the applications layer 
distinct from a forms editing protocol. By separating these 
functions according to classes it is possible to build a variety 
of compatible products which conform to a common set of functions 
within a given class of operations. . 
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1.4 SCOPE 

The interfaces defined within this specification apply to both 
internal and external product interfaces. External interfaces are 
interfaces between a terminal, personal computer or workstation 
and a remote system. Internal interfaces are interfaces between a 
terminal sub- system and software processes running within a 
terminal, personal computer or workstation. 
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1.5 ARCHITECTURAL CONFORMANCE 

The Video Systems Reference Manual is based on a modular 
architectural structure made up of discrete components which can 
be combined in a variety of ways to meet evolving product needs 
and requirements. For purposes of defining conformance, service 
class interfaces can be further subdivided into levels, 
extensions, and exceptions. The following definitions describe 
these concepts. 


1.5.1 Definitions 

1.5. 1.1 Levels - 

Levels reflect an agreement between software and hardware on a 
fixed group of functions within a class of operations that are to 
be adhered to for some period of time. When significant new 
functionality is required to be added, a new level will be defined 
and agreed to, which will be a super set of the levels below. 
Lower levels of the architecture may be discontinued from use as 
new higher levels are defined. The decision to discontinue a 
lower level wiHrHae based on marketing and product requirements. 

Each level will consist of a number of functions which must be 
included .in all products claiming to implement that level. These 
I functions are referred to as "required". When a level n function 
I is used in level n-i-1 operation, it must be defined in such a way 

I that it will not affect any level n state differently than it does 
I in level n, to insure compatibility for level n conforming 
I software running in level n+1. 

The advantage of having levels is that software can be written to 
a specific level of functionality based on hardware availability 
and compatibility requirements, and will be guaranteed all of the 
functionality of that level and all lower levels. As new levels 
are adopted, terminals can be upgraded to support the new levels 
without losing compatibility with existing software. Likewise, 
software can be intelligently upgraded to support new terminal 
products without losing backwards compatibility with previous 
levels of the architecture. 


1.5. 1.2 Extensions - 

In order to minimize the number of service classes and levels 
supported by the architecture, and still meet a wide variety of 
product needs, each level of the architecture will have certain 
defined extensions. Extensions are fully specified by the 
architecture, but are optional to product implementors claiming to 
conform to a particular level of the architecture. (Products may. 
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in fact, permit the customer to optionally purchase extensions.) 
Functions which are included as extensions are not guaranteed to 
software, and therefore conforming software should not be 
dependent on those functions to operate in a logical and reliable 
manner. For example, 132-column mode is an extension to the 
Character Cell Display service class, and thus might not be 
included in all products. Software should be designed in such a 
way that it will behave in a logical manner if this feature is not 
present in a particular terminal product. 


1.5. 1.3 Exceptions - 

Each level may also include a set of "exceptions". These 
functions are not required by product implementations, and are not 
to be used by conforming software. For example, Tektronix 4010 
emulation might be required by particular products, but not be a 
part of the architecture because DEC software did not want to 
support this feature. The interface, however, would be documented 
and included as an appendix to the architecture, so that products 
implementing this feature could do so in a compatible manner. 

Products must get management approval before using exceptions to 
the architecture, and any new exception specifications must be 
approved by the Terminal Interface Architecture Review Board 
before being implemented. 


1.5. 1.4 Exclusions - 

In rare cases there may be certain functions which are explicitly 
excluded from a given level. This will typically be done to 
clarify that a particular function is not allowed for 
implementation at that level. 


1.5. 1.5 Waivers - 

Products which cannot pass certification cannot claim conformance 
with the architecture unless they receive a formal waiver from 
Terminals and Workstations management. The following are examples 
of conditions for which a waiver might be granted: 

1. If a product wished to implement functions which were not 
previously defined by the architecture, and were not 
warranted to be general enough to require 
architectural development. 


new 
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2. If a product were incapable of properly implementing a 
defined function for sound technical reasons, but in 
other ways conformed to the architecture. 

3. If a product conforming to a certain level wished to 
include functioas defined by a higher level, but not 
implement all of the functions of that level. 

Waivers are intended to be used to resolve time-to-market issues 
and are temporary. Products not conforming are expected to come 
into conformance by changing the product, or by changing the 
architecture through the Architecture ECO process. 


1.5. 1.6 Deviations - 

Deviations represent permanent non-conformance with the 
architecture. Deviations apply only to products which were 
developed before the architecture was defined, but are in general 
conformance with the architectural specifications. New products 
are not allowed deviations. 


1.5. 1.7 UNDEFINED Operations - 

Occasionally there are operations whose effect cannot be 
guaranteed to be the same in all implementations. Such operations 
shall be identified in both the architectural and product 
specifications as UNDEFINED. Software conforming to the 
architecture shall not use UNDEFINED operations. Every attempt 
will be made to minimize the number of UNDEFINED operations in the 
architecture, since software ' that executes UNDEFINED functions may 
not operate the same on all terminal products. 


1.5.2 User Preference Features 

Certain states of the terminal are defined as "User Preference 
Features". User Preference Features that have a coded 
representation for interchange with a host are indicated to be of 
a special status in this specification. 

The terminal user should be in charge of the state of all User 
Preference Features, not the general application program. 
Conforming software applications shall not change the state of any 
User Preference Feature, except in response to an explicit 
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request by the terminal user. It is preferred that these requests 
be handled as an operating system service. In cases where these 
services are not provided by the operating system, and these 
functions are changed by an application program, the operating 
system must be notified. 


1.5.3 Rules For Conformance 

Terminal and Workstation products will be required to provide 
standard interfaces for the purpose of synchronizing hardware 
product release with software product support. To this end, it is 
important that products claiming to conform to the architecture 
should follow certain guidelines in implementing the architectural 
interfaces. Products should not be excluded from implementing 
features not defined by the architecture. However, it should be 
made clear in both the architectural and product documentation 
that these features are not guaranteed in all products, and should 
not be used by conforming software. Products should not be 
allowed to selectively implement portions of the architecture 
without receiving an explicit. waiver from Terminals and 
Workstations management prior to beginning any product 
development, as — this will render the architecture useless in 
determining cross- pr oduct compatibility. 


1.5. 3.1 Hardware/Firmware Conformance 


1.5. 3. 1.1 Levels - Terminal hardware/firmware claiming to conform 
to Level n; 

1. shall implement ALL functions of the lowest defined level 
to Level n, 

2. may NOT implement any functions defined by a higher level 
unless it implements all of the functions of that level 
(in which case it would conform to the higher level), 

3. may NOT implement any function not defined in any level 
(unless it is included in an appendix to both the 
architectural and product specifications and clearly 
identified as an exception to the architecture) . 

For example, a conforming Level 1 implementation cannot leave out 
bold, since it is a Level 1 function (however, bold may be 
implemented either by increasing the intensity or the number of 
pixels). A conforming Level 1 implementation cannot implement any 
Level 2 functions (or it must implement all of the Level 2 
functions, in which case it is a Level 2 conforming terminal). 
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1.5. 3. 1.2 Extensions - 

Terminal hardware/firmware claiming to implement an extension 
shall implement ALL functions of that extension and the associated 
conformance level, but need not implement any lower level 
extensions, unless specifically required by the specification of 
the extension. 


1.5. 3. 1.3 Exceptions - 

Finally, a conforming terminal may NOT implement any VT100/VT125 
function that has been excluded from all of the levels by this 
document, unless it has been included in an appendix to this 
document. Such functions * will be defined for backward 
compatibility with existing terminals. However, conforming DEC 
software shall NOT use those functions defined in an appendix. 


1.5. 3. 2 Software Conformance - 


1.5. 3. 2.1 Levels - Software claiming to conform to Level n; 


1. may use ANY functions in the lowest defined level to 
Level n, 

2. shall NOT use any functions of levels higher than n, 

3. shall NOT use any functions defined in an appendix of the 
SRM, 

4. shall NOT depend on product-specific side effects which 
are left UNDEFINED by the architecture. 
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1.5. 3. 2. 2 Extensions - 

Software supporting an extension may use any function in that 
extension (and any extensions which are required to support that 
extension), but shall use the functions in such a way as to make 
I the software modular with respect to extensions when it makes 
I sense to do so. Furthermore, software that supports an extension 
shall operate in a sensible way if that extension is NOT present 

I in the terminal. The intent of this requirement is two-fold. 

I First, no conforming software should ever blindly assume that it 
I is using a terminal with an extension which it requires. All 
I software must verify that its environment is correct. Second, if 
I the software determines that it does not have the required 
I facilities, it must behave rationally. This could mean that 
I certain features of the software are inoperative. Or, if the 

I entire software package requires an extension (e.g., DECgraph and 

I ReGIS), then rational behavior means exiting gracefully with an 
I appropriate informational message. 


1.6 LEVEL 1 CONFORMANCE 

Level 1 of the architecture — provides a compatibility mode for 
software designed to operate with the VTIOO family of display 
terminals, specifically the VT102 display terminal and VT125 
graphics display terminal. 


1.6.1 Conforming Products 

For a list of conforming Level 1 products, consult the appendix 
"Product Reference". 
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1.6.2 Required Functions 

The following controls are required for all conforming Level 1 
implementations. 


NUL NUL 

SPACE SP 


SHIFT IN (LOCKING SHIFT ZERO) 

SI (LSO) 

SHIFT OUT (LOCKING SHIFT ONE) 

SO (LSI) 

SINGLE SHIFT TWO 

SS2 

SINGLE SHIFT THREE 

SS3 

IDENTIFICATION 

DECID 

DEVICE STATUS REPORT 

DSR 

SET TOP AND BOTTOM MARGINS 

DECSTBM 

SELECT CHARACTER SET to GO, G1 

ASCII 

Line Drawing 

SELECT GRAPHIC RENDITION 

SGR 

Normal 


Bold 

Blink 

Underscore 

Reverse Video 

SINGLE WIDTH LINE 

DECSWL 

DOUBLE WIDTH LINE 

DECDWL 

DOUBLE HEIGHT LINE TOP 

DECDHLT 

DOUBLE HEIGHT LINE BOTTOM 

DECDHLB 

Set/Reset Mode 

SM,RM 

SCROLLING MODE 

DECSCLM 

SCREEN MODE 

DECSCNM 

ORIGIN MODE 

DECOM 

NEW LINE MODE 

LNM 

KEYBOARD ACTION MODE 

KAM 

AUTO REPEAT MODE 

DECARM 

CURSOR KEY MODE 

DECCKM 

KEYPAD MODE 

DECKPAM,DECKPNM 

CURSOR UP 

CUU 

CURSOR DOWN 

CUD 

CURSOR FORWARD 

CUF 

CURSOR BACKWARD 

CUB 

CURSOR POSITION 

CUP 

HORIZONTAL/VERTICAL POSITION 

HVP 

CURSOR POSITION REPORT 

CPR 

SAVE CURSOR 

DECSC 

RESTORE CURSOR 

DECRC 

BEL 

BEL 

BACK SPACE 

BS 

HORIZONTAL TAB 

HT 

LINE FEED 

LF 
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VERTICAL TAB VT 

FORM FEED FF 

CARRIAGE RETURN CR 

SUBSTITUTE SUB 

INDEX IND 

REVERSE INDEX RI 

NEXT LINE NEL 

HORIZONTAL TABULATION SET HTS 

TABULATION CLEAR TBC 

ERASE IN LINE EL 

ERASE IN DISPLAY ED 
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1.6.3 Extensions To Level 1 

The following functions are each independent extensions to Level 1 
as an implementation or customer option, and require the 
associated controls. 


1.6. 3.1 Identification And Conformance - 

The following functions form an extension to Level 1 that is 
required in all future products, and in Level 2: 

DEVICE ATTRIBUTES (primary) DA(1) 

DEVICE ATTRIBUTES (secondary) DA(2) 

SELECT CONFORMANCE LEVEL DECSCL 


1.6. 3. 2 Editing Controls - 

The following editing controls form an extension to Level 1 that 
is required in all future products, and in Level 2: 


Set/Reset Mode 

SM,RM 

INSERT/REPLACEMENT MODE 

IRM 

DELETE CHARACTER 

DCH 

INSERT LINE 

IL 

DELETE LINE 

DL 


1.6. 3. 3 132-Column Mode - 

Set/Reset Mode SM,RM 

COLUMN MODE DECCOLM 


1.6. 3. .4 Printer Port - 


DEVICE STATUS REPORT DSR 

Set/Reset Mode SM,RM 

PRINTER CONTROLLER MODE DECPCM 

AUTO PRINT MODE DECAPM 

PRINT FORM FEED MODE DECPFF 

PRINT EXTENT MODE DECPEX 

Media Copy MC 

PRINT SCREEN 
PRINT LINE 
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1.6. 3. 5 ReGIS Graphics Display - 

I Set/Reset Mode SM,RM 

1 GRAPHICS CURSOR ENABLE MODE DECGCEM 

1 

I Media Copy MC 


Device Control String 
ENTER ReGIS GRAPHICS 


DCS, ST 


ReGIS Commands 

SCREEN CONTROL S 
POSITION CONTROL P 
WRITING CONTROL W 
VECTOR DRAWING V 
CURVE DRAWING C 
TEXT DRAWING T 
REPORT R 
LOAD CHARACTER SET L 
MACROGRAPH M 


1.6. 3. 6 Sixel Protocol - 

I As defined in the section "Sixel Graphics Extension" 


1.6. 3.7 Katakana Character Set - 

SELECT CHARACTER SET to GO, G1 
JIS_ Roman 
JIS Katakana 
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1.6.4 Level 1 User Preference Features 

The following functions are included in Level 1 operation, but are 
indicated as User Preference Features, and thus are not to be used 
by conforming DEC application programs (except as described 
above ) : 


Set/Reset Mode SM,RM 

COLUMN MODE DECCOLM 

SCROLLING MODE DECSCLM 

SCREEN MODE DECSCNM 

AUTO REPEAT MODE DECARM 
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1.7 LEVEL 2 CONFORMANCE 

Level 2 defines a new level of architectural compatibility for 
video display terminals which is a complete super set of Level 1. 


1.7.1 Conforming Products 

For a list of conforming Level 2 products, consult the appendix 
"Product Reference". 


1.7.2 Required Functions 

The following controls are required for all conforming Level 2 
implementations . 


All Level 1 required functions, ' and all Level 1 extensions 
required for future products, plus: 


SELECT 7 -BIT Cl TRANSMISSION 
SELECT 8 -BIT Cl TRANSMISSION 
LOCKING SHIFT TWO 
LOCKING SHIFT THREE 
LOCKING SHIFT ONE RIGHT 
LOCKING SHIFT TWO RIGHT 
LOCKING SHIFT THREE RIGHT 


S7C1T 

S8C1T 

LS2 

LS3 

LSIR 

LS2R 

LS3R 


SOFT TERMINAL RESET 


DECSTR 


SELECT CHARACTER SET to GO , G1 , G2 , G3 
ASCII 

Line Drawing 
Supplemental 
Set/Reset Mode 

TEXT, CURSOR ENABLE MODE 
! INSERT CHARACTER 
i ERASE CHARACTER 


SM,RM 

DECTCEM 

ICH 

ECH 


1.7.3 Extensions To Level 2 

The following functions are each independent extensions to Level 2 
as an implementation oj: customer option, and require the 
associated controls. 
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1.7. 3.1 132 -Column Mode - 

All Level 1 required functions for this extension. 

1.7. 3. 2 Printer Port - 

All Level 1 required functions for this extension. 

1.7. 3. 3 ReGIS Graphics Display - 

All Level 1 required functions for this extension. 

1.7. 3. 4 Sixel Protocol - 

All Level 1 required functions for this extension. 

1.7. 3. 5 Katakana Character Set - 

All Level 1 required functions for this extension. 

I 1.7. 3. 6 Selectively Erasable Characters - 

I SELECT CHARACTER ATTRIBUTE DECSCA 

I SELECTIVE ERASE IN LINE DECSEL 

I SELECTIVE ERASE IN DISPLAY DECSED 

1.7. 3. 7 DRCS (Dynamically Redefinable Character Set) - 

DOWN LINE LOAD DRCS DECDLD 

SELECT CHARACTER SET to GO, G1 , G2 , G3 
DRCS 

1.7. 3. 8 UDK (User Defined Keys) - 


DEVICE STATUS REPORT 
USER DEFINED KEYS 


DSR 

DECUDK 
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1.7.4 Level 2 User Preference Features 

The following functions are included in Level 2 operation, but are 
indicated as User Preference Features, and thus are not to be used 
by conforming DEC application programs (except as described 
above ) : 


Set/Reset Mode SM,RM 

COLUMN MODE DECCOLM 

SCROLLING MODE DECSCLM 

SCREEN MODE DECSCNM 

AUTO REPEAT MODE DECARM 
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1.8 CERTIFICATION 

Certification testing is performed on products .claiming to conform 
to the architecture by the Terminals and Workstations 
Certification Group. Products may not claim compatibility with 
the architecture or with other Terminals and Workstations products 
unless they have -passed certification testing, or have been given 
specific clearance to do so by Terminals and Workstations 
management. 

The goal of Certification is to prove a product's compatibility 
claims, not according to its own interpretation of what is 
required for compatibility, but as defined in The Video Standards 
Systems Reference Manual (DEC Standard 070). This means that 
multiple products will use the same set of Certification tests. 

Certification assumes the unit functions, but checks if the 
functions were implemented in a compatible manner. It is also 
important to note that certification testing is limited to that 
subset of functions which are either required functions or 
extensions to the architecture. This implies that a product that 
passes certification may have problems executing commands which 
are not part of that subset. 

Outstanding certification issues are handled through the Waiver 
Process, and are not likely to cause a delay in shipment. 
Non-compliances are brought to the attention of upper management 
who can then decide to restrict the advertising of certain 
compatibility claims until the product passes certification. 
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1.8.1 Certification Test Process 
Certification is a five step process: 


1. -Review Architectural and Product Specifications 

The Certification Group participates in the review of new 
architectural elements, and attempts to uncover 
discrepancies between the architecture and the 
implementation even before hands-on testing begins. 

The Certification Group, in cooperation with Architecture 
Group, will decide the LEVEL that the product must be 
tested against based on the list of implemented functions 
contained in the Product Specification. 


2. Design Tests 


3. Run Tests 


4. Report Results 

Certification Reports list deviations between the 
architecture and the implementation. Interim reports are 
produced periodically, and a final certification report 
is published at the end of the testing. It is the final 
certification report that is used as the input to the 
Waiver Process. 


5. Chair the Waiver Panel 

The Certification Group conducts Waiver Panel meetings, 
seeks resolution of compatibility issues, obtains 
commitments for any proposed changes, and publishes the 
results. 
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1.8.2 The Waiver Process 

1.8. 2.1 General Information - The Terminals & Workstations 
Certification Waiver Panel is composed of three people; one 
representative from Product Development, one from Architecture, 
and a non-voting chair person from Certification. . Others may 
attend the meetings of the Waiver Panel and can participate in the 
discussions, but they have no vote. 

The Waiver Panel is responsible for reviewing the deviations 
between the architecture and implementation as documented in the 
Certification Report, for assessing the technical and business 
impact of every deviation, and for recommending an appropriate 
resolution for every deviation. 


1.8.3 Resolution Of Open Issues 

There are six possible recommendations that the Waiver Panel will 
make for each level of certification under consideration: 


1. —Change The Product; 

It is agreed that the problem must be fixed, but that 
because plans are in place to do so by a specified time, 
a waiver is granted. 


2. Change The Architecture: 

It is agreed that the product was implemented in a 
reasonable fashion and the Architecture may need 
clarification. 


3. Change The Certification Procedure: 

It is agreed that the certification process was in error 
in that it either failed to properly interpret the 
architecture or failed to properly test the product. 


4. Waive By Agreement of The Panel: 

It is agreed that no change is to be made at this time to 
the product, the architecture or the certification 
procedures. By granting this waiver, the Panel is 
expressing the opinion that it considers the issue 
insufficient cause for the product to fail certification. 
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5. Restrict; 

It is agreed that although no change to the product is 
involved at this time, the deviation is serious enough to 
warrant placing a restriction on what compatibility or 
other claims the product should be allowed to make. 


6. No Resolution: 

The Waiver Panel was unable to agree on a resolution for 
the issue or on the proposed time frame for resolution, 
and will present it to upper management for a decision. 


1.8. 3.1 Results Of The Waiver Process - The Waiver Panel will 
determine a final disposition for each level of certification 
under consideration. Accordingly, the results for a particular 
level can be: 

o PASSED CERTIFICATION 

o PASSED CERTIFICATION WITH WAIVERS - No category 5 or 
category 6 deviations 

o PASSED CERTIFICATION WITH RESTRICTION - No category 6 
deviations, one or more category 5 deviations 

o FAILED CERTIFICATION - One or more category 6 deviations 


In addition , ■ the Waiver Panel may wish to ' state any other 
restrictions which it agrees should be placed on the product. 
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1.9 CHANGE HISTORY 
1.9.1 Revision 0.0 To AXIO 


1. This section was merged with the introductory section, 
the remainder of which now forms section 0 of the 
standards . 

2. Removed DELETE as a required Level 1 function. (It is 
ignored as an unimplemented Cl control. Its use as a pad 
character should be discouraged in favor of NUL). 

3. Removed Answerback (ENQ) and Test (DECTST) as required 
functions for both Level 1 and Level 2 conformance. They 
will be included as an appendix to the SRM. 

4. Added VTl25-type Media Copy (MC) controls to the ReGIS 
extension requirements for Levels 1 and 2. 

5. Removed Hard Copy (DECHCP) as a requirement for the sixel 

extension in Levels 1 and 2. The only required way to 
access the sixel format is through the ReGIS S(H) 
command. 

6. Removed Control Representation Mode (CRM) as a Level 2 
requirement. CRM will be defined in an appendix to the 
SRM. 

7. Added Insert Character (ICH) and Erase Character (ECH) as 
Level 2 requirements. 

8. Added Selectively Erasable Characters as a Level 2 
Extension. 

9. Added Device Status Report (DSR) to the UDK extension for 
Level 2. DSR is used to return the lock conditions of 
the User Defined Keys. 

10. Made IRM, DL, IL, and DCH part of an Editing Extension to 
Level 1 that is required in all future products (and in 
Level 2 ) . 

11. Added a complete description of the Certification process 
and the waiver procedure. 
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VIDEO SYSTEMS REFERENCE MANUAL 
Specification Program Structure 


Document Identifier: A-DS-EL00070-02-0 Rev. AXll, 18-Mar-1985 


ABSTRACT: This document describes the algorithmic specification 
language used in the Video Systems Reference Manual and the 
program flow across sections of the Manual. 


APPLICABILITY: SARA Formal Cross - Component Standard. Mandatory 
for Engineers designing hardware for terminal products and 
Software Engineers designing programs using terminal interfaces. 
Additional requirements are defined in the section "Concepts and 
Conformance Criteria". 


STATUS: FOR REVIEW ONLY 


1 This document has been placed in the SARA "Formal | 

I Cross -Component Standard" category. The material contained j 

I within this document is assumed to define mandatory standards | 

I unless it is clearly marked as (a) not mandatory or j 

I (b) guidelines. Material which is marked as "not mandatory" is j 
j considered to be of potential benefit to the corporation and j 
I should be followed unless there are good reasons for j 

1 non-compliance. "Guidelines" define approaches and techniques j 
I which are considered to be good practice, but should not be j 
I considered as requirements. The procedures for modifying or j 
I evolving this standard are contained within the contents of 1 
I this document. | 

+ + 
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2.1 INTRODUCTION 

This section contains information regarding the coding methods 
used within the Video Systems Reference Manual to specify the data 
types for terminal state information, and to describe the control 
operations which affect the state of the device. - -It also 
describes the program structure across sections of the manual, and 
includes the top level routines which bind the program sections 
together. It should serve as a reference point for understanding 
the relationship of the detailed algorithms which appear 
throughout the specifications. However, it is not intended to be 
a complete or thorough implementation of the architecture as 
described herein. 


2.1.1 Algorithmic Specification 

The coding of algorithms within -this specification is intended to 
serve as a guideline to implementors, and as a clear specification 
of the interfaces rules against which product certification can be 
performed. The code is optimized for architectural clarity. It 
is intended to be as efficient as possible, but it is recognized 
that — specific implementations may alter the algorithms or program 
stru£t.ure in order to optimize for memory or execution speed. 
They must do so, however, without sacrificing the functionality or 
rules provided by the algorithms. 

In other words, for all possible received interchange, conforming 
implementation algorithms shall produce identical results to the 
program specifications in terms of the presentation on the visual 
display and the state variables that an application process can 
solicit from the terminal. 


2.1.2 Use Of Pascal 

.Pascal was selected as an architectural implementation language 
because of its rigid structure and type checking, simplicity, and 
wide usage both inside and outside of DEC. Standard Pascal has 
been used throughout, with the following exceptions: 

underline is allowable in user-defined symbols 

forward declaration of procedures and functions is 
implied 

OTHERWISE is used as an exception condition for case 
statements 
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Implementation Notes: 

1. Because PACKED ARRAYS are provided by Pascal as an 
implementation technique, to optimize storage 
requirements at the expense of execution speed, they are 
not utilized within this specification. 

2. The internal procedure IGNORE is a null operation, which 
is used throughout the specification in order to leave as 
little room as possible for interpretation of undefined 
states of the device. 
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2.2 SPECIFICATION PROGRAM STRUCTURE 

The following diagram is provided as an overview to the structure 
of the coded algorithms within this manual. It is not intended as 
a detailed description of the program logic. 


EXECUTIVE LOOP ===> GET . NEXT . EVENT 
(ANSI PARSER) 


• 

• 

• 

' • 


INSERT OR 

1 EXECUTE 

1 EXECUTE 

1 EXECUTE 

1 EXECUTE 

REPLACE 

1 CONTROL 

1 ESCAPE 

1 CONTROL 

1 CONTROL 

CHARACTER 

1 CODE 

1 SEQUENCE 

1 ......... 

1 SEQUENCE 

1 STRING 

i .......... 


1 

1 BEL 

1 

IDECSC 

|ICH (2) 

1 

iDCS (ReGIS) 


1 BS 

IDECRC 

1 CUU 

DCS (Sixel) 


1 HT 

1 DECDHLT 

1 CUD 

|DCS (DRCS) 


1 LF 

1 DECDHLB 

CUF 

IDCS (UDK) 


I VT 

1 DECSWL 

1 CUB 

IBS 


1 FF 

1 DECDWL 

|CUP 

1 HT 


1 CR 

is7ClT (2) 

I ED 

1 LF 


1 SO 

iSSClT (2) 

IDECSED (2X) 

VT 


1 SI 

|LS2 (2) 

1 EL 

1 FF 


1 SUB 

|LS3 (2) 

IDECSEL (2X) 

1 CR 


IND 

ILSIR (2) 

IIL (IX, 2) 

1 ST 


i NEL 

iLS2R (2) 

|DL (IX, 2) 



1 HTS 

|LS3R (2) 

IDCH (IX, 2) 



RI 

|SCS 

|ECH (2) 



1 SS2 


|DA1 



1 SS3 


1 DA2 ( 2 ) 



HVP 

TBC 

SM 

MC (1X,2X) 

RM 

SGR 

DSR 

DECSCL (2) 
DECSCA (2X) 
DECSTBM 


general purpose routines 
END _ OF _ LINE SCROLL UP 



SCROLL . DOWN IGNORE 


Program Flow Diagram 
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2.3 SUMMARY OF STATE 

2.3.1 Code Extension Layer - Parsing 


CONST MAX. NUM. INTERMEDIATES * 3; 

MAX. NUM. PARAMETERS =16; 

MAX. PARAMETER. VALUE = 16384; 

I RANGE. PRIVATES - 2; 

I TYPE EVENT. TYPE = ( GRAPHIC . CODE , CONTROL . CODE , ESCAPE. SEQUENCE , 

I CONTROL . SEQUENCE , DCS . INTRODUCER ) ; 

I CODE. TYPE = 0..255; (* legal 8-bit code values *) 

I INTERMEDIATE TYPE = 32.. 47; (* legal intermediate values 

I *) 

I PARAMETER. TYPE = 0 .. MAX . PARAMETER . VALUE ; 

I ROW. COLUMN. TYPE = 0..15; 

SEQUENCE . TYPE » ( ESCAPE , CONTROL , DCS ) ; 

EVENT. BUFFER. TYPE = RECORD 
EVEiW-.CODE: EVENT. TYPE; 

CODE_ VALUE: CODE. TYPE; 

INTERMEDIATE . COUNT ; 0 . . MAX . NUM . INTERMEDIATES ; 
INTERMEDIATES; 

ARRAY [1. .MAX. NUM. INTERMEDIATES] OF INTERMEDIATE . TYPE ; 
PARAMETER . COUNT : 0 . . MAX . NUM . PARAMETERS ; 

PARAMETERS ; 

ARRAY [ 1 . .MAX. NUM. PARAMETERS ] OF PARAMETER. TYPE ; 

I PRIVATE. PARAMETER; O..RANGE.PRIVATES; 

VALID. SYNTAX; BOOLEAN; 

(* The following values are internal state variables 
required by the parser. Note that the boolean flag 
SEQUENCE. IN. PROGRESS must be initialized to FALSE 
by the calling routine prior to the first time the 
parser is invoked. *) 

SEQUENCE. IN. PROGRESS: BOOLEAN; 

I KIND. OF. SEQUENCE: SEQUENCE.TYPE; 

PARAMETER. OVER FLOW: BOOLEAN; 

END; 


VAR 


EVENT; EVENT. BUFFER. TYPE; 
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2.3.2 Code Extension Layer - Graphics 


TYPE GRAPHIC. CHARACTER. SET, TYPE = 

( ASCI i.G, SUPPLEMENTAL. G, LINE. DRAWING, (* Standard *) 
JIS.ROMAN, JIS.KATAKANA, (* extension *) 

DRCS); (* extension *) 

CO. CONTROL. CHARACTER. SET. TYPE = (ASCII.C); 

Cl .CONTROL. CHARACTER. set] TYPE » (SUPPLEMENTAL.C); 

DESIGNATED. GRAPHIC. SET. TYPE = ( GO , G1 , G2 , G3 ) ; 

IN. USE. TABLE. TYPE = RECORD 

CO ; CO . CONTROL . CHARACTER . SET . TYPE ; 

GL: GRAPHIC. CHARACTER. SET. TYPE; 

INVOKED. GL: DESIGNATED. GRAPHIC. SET. TYPE; 

Cl : Cl . CONTROL . CHARACTER . SET . TYPE ; ’ 

GR: GRAPHIC. CHARACTER. SET. TYPE; 

INVOKED GR: DESIGNATED GRAPHIC SET TYPE; 

END ; 

EN^^IRONMENT.TYPE = ( SEVEN . BIT , EIGHT. BIT); 


VAR IN. USE. TABLE: IN. USE. TABLE. TYPE; 

DESIGNATED. GRAPHIC. SETS: 

ARRAY [G0..G3] OF GRAPHIC.CHARACTER.SET.TYPE; 

HOST. PORT. ENVIRONMENT; ENVIRONMENT . TYPE ; 

Cl .TRANSMISSION.MODE; ENVIRONMENT. TYPE; 

SINGLE. SHIFT; (NONE, SS2, SS3); 
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2.3.3 Terminal Management 


CONST MAX _NUM. OPTIONS = (* defined by implementation *); 

max] POSITION * 20 .(* Level 1 *); 

30 (* Level 2 *); 

TYPE EXTENSION. TYPE * 

( ONE . THIRTY . TWO . COLUMN , PRINTER . PORT . EXT , 

REGIS . GRAPHI CS , S IXEL . GRAPHICS , ^TAKANA . EXT , 

SELECTIVELY . ERASABLE ] CHARACTERS , DRCS . EXT , UDK . EXT ) ; 

VAR SERVICE. CLASS: INTEGER; 

CONFORMANCE . LEVEL ; ( LEVEL . 1 , LEVEL . 2 ) ; 

LEVEL. 1 . EXTENSIONS : 

ARRAY [ ONE. THIRTY. TWO. COLUMN. .KATAKANA. EXT] OF BOOLEAN; 
LEVEL . 2 . EXTENS I ONS ; ' 

ARRAY [ONE. THIRTY. TWO. COLUMN. .UDK. EXT] OF BOOLEAN; 
PRODUCT. ID: INTEGER; 

REVISION. LEVEL: INTEGER; 

PRODUCT. OPTIONS: ARRAY [ 0 .. MAX. NUM. OPTIONS ] OF INTEGER; 

ANSWERBACK . MESSAGE . BUFFER : 

ARRAY [1. .MAX. POSITION] OF CODE.TYPE; 

DEVICE. STATUS: ( READY, MALFUNCTION) ; 

POWER. ON: BOOLEAN; 

IN. CONTROL. STRING: BOOLEAN; 
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2.3.4 Character Cell Display 


CONST MAX. NUM. LINES =24; 

MAX. NUM. COLUMNS = 132; 

EMPTY. CHARACTER =0; 

MAX.NUM. CHARACTER. SETS =4; (* for Level 2 with DRCS *) 

TYPE LINE. TYPE = 1 . .MAX. NUM. LINES ; 

COLUMN. TYPE = 1 .. MAX . NUM . COLUMNS ; 

CHARACTER. POSITION. TYPE = RECORD 
LINE: LINE. TYPE; 

COLUMN: COLUMN. TYPE; 

END ; 

GRAPHIC. RENDITION. TYPE = 

( BOLD , BLINK , UNDERSCORE , REVERSE ) ; 

CHARACTER. RENDITION. TYPE = 

ARRAY [GRAPHIC. RENDITION. TYPE] OF BOOLEAN; 

LOGICAL. ATTRIBUTE. TYPE = ( SELECTIVELY. ERASABLE ) ; 

CHARACTER. ATTRIBUTE. TYPE = 

ARRAY [LOGICAL. ATTRIBUTE. TYPE] OF BOOLEAN; 

LINE. RENDITION. TYPE = 

( DOUBLE . HEIGHT . TOP , DOUBLE . HEIGHT . BOTTOM , 

SINGLE. WIDTH, DOUBLE. WIDTH) ; 

CHARACTER. TYPE * RECORD 

CODE: 0..126; {*0 is used for empty characters *) 
RENDITION: CHARACTER. RENDITION. TYPE; 

ATTRIBUTE : CHARACTER . ATTRIBUTE . TYPE ; 

CHARACTER . SET : GRAPHIC . CHARACTER . SET . TYPE ; 

END; 

CHARACTER. SET. DESIGNATOR. TYPE = RECORD 
NAME: G^PHI C. CHARACTER. SET. TYPE; 

FIRST. INTERMEDIATE: 0..47; (* 0 = no intermediate *) 
SECOND. INTERMEDIATE: 0..47; 

FINAL: 0..126; (* 0 indicates no table entry *) 

END ; 

ORIGIN. MODE TYPE = ( ABSOLUTE , DISPLACED ) ; 
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SAVE. BUFFER. TYPE = RECORD 

POS I TI ON : CHARACTER . POS I TI ON . TYPE ; 

RENDITION : CHARACTER. RENDITION . TYPE ; 

ORIGIN. MODE; ORIGIN. MODE. TYPE; 

LEFT: GRAPHIC. CHARACTER. SET. TYPE; 

RIGHT: GRAPHIC. CHARACTER. SET. TYPE; 

SETS: ARRAY [CS0..G3] OF GRAPHIC . CHARACTER. SET. TYPE ; 
ATTRIBUTE : CHARACTER. ATTRIBUTE . TYPE ; 

END; 


VAR DISPLAY: ARRAY [ LINE. TYPE , COLUMN. TYPE ] OF CHARACTER. TYPE ; 

LINE. RENDITION: ARRAY [LINE. TYPE] OF LINE . RENDITION. TYPE ; 
ACTIVE. POSITION; CHARACTER. POSITION. TYPE ; 

TOP. MARGIN: LINE. TYPE; 

BOTTOM. MARGIN: LINE. TYPE; 

CURSOR. SAVE. BUFFER: SAVE . BUFFER. TYPE ; 

CURRENT . RENDITION : CHARACTER . RENDITION . TYPE ; 

CURRENT ] ATTRIBUTE : CHARACTER ] ATTRIBUTE . TYPE ; 

CHARACTER . SET . TABLE ; 

ARRAY [i. .MAX. NUM. CHARACTER. SETS] OF 
CHARACTER . SET ] DESIGNATOR . TYPE ; 

HORIZONTAL. TAB. STOPS: ARRAY [ COLUMN. TYPE ] OF BOOLEAN; 
COLUMN. MOBE; ( EIGHTY, ONE . THIRTY. TWO ) ; 

SCROLLING. MODE: (JUMP, SLOW); 

SCREEN . MODE : { NORMAL . SCREEN , REVERSE . SCREEN ) ; 

ORIGIn]mODE; ORIGIN. MODE . TYPE ; 

AUTO . W^P . MODE ; ( WRAP . OFF , WRAP . ON ) ; 

TEXT . CURSOR . ENABLE . MODE ; ( TEXT . CURSOR . OFF , TEXT . CURSOR .ON); 

INSERT. REPLACEMENT [mode; (REPLACE,INSERT); 

NEW. LINE. MODE: ( NEW. LINE .OFF , NEW. LINE . ON ) ; 
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2.3.5 Keyboard Processing 


VAR KEYBOARD. ACTION. MODE: (UNLOCKED,LOCKED); 

AUTO. REPEAT. MODE: ( REPEAT. OFF, REPEAT. ON) ; 

CURSOR. KEY. MODE; ( CURSOR, CK. APPLICATION ) ; 

KEYPAD. MODE: (NUMERIC,KP.APPLICATION); 

KEYBOARD. USAGE. MODE: (TYPEWRITER, DATA. PROCESSING) ; 
CAPS. SHI FT. LOCK. MODE: ( CAPS. LOCK, SHIFT. LOCK) ; 

HOLD . SCREEN . MODE : ( HOLD . OFF , HOLD . ON ) ; 

LOCK. MODE; ( LOCK. OFF, LOCK. ON) ; 

COMPOSE. MODE: ( COMPOSE. OFF, COMPOSE. ON) ; 
KEYCLIck.MODE; ( KEYCLICK . OFF , KEYCLICK .ON ) ; 


2.3.6 Printer Port Extension 


VAR PRINTER. PORT. ENVIRONMENT; ENVIRONMENT. TYPE ; 

PRINTER . STATUS ; ( PRINTER . READY , PRINTER . NOT . READY , 

PRINTER. NOT. PRESENT ) ; 

PRINTER. STYLE: ( ASCII . ONLY, ASCI I . PLUS , FULL . 8 . BIT ) ; 

PRINTER. CONTROLLER. MODE : 

( PRINTER . CONTROLLER . OFF , PRINTER . CONTROLLER .ON); 

AUTO. PRINT. MODE; (AUTO . PRINT. OFF , AUTO. PRINT. ON ) ; 

PRINT. FORM. FEED. MODE; ( PRINT* FF . OFF , PRINT. FF _ ON ) ; 

print] EXTENT. MODE: ( PRINT. SCROLLING. REGION, PRINT. DISPLAY) ; 


2.3.7 Extensions 


VAR GRAPHICS. CURSOR. ENABLE. MODE; 

( GRAPHICS . CURSOR . ON , GRAPHICS . CURSOR . OFF ) ; 

REGIS. GRAPH ICS. MODE; ( REGIS . OFF , REGIS . ON ) ; 

S I XEL. GRAPH ICS. MODE: ( SIXEL . OFF , SIXEL . ON ) ; 

LOAD . DRCS . MODE ; ( DRCS . LOAD . OFF , DRCS . LOAD . ON ) ; 

LOAD . UDK . MODE : ( UDK . LOAD . OFF , UDK . LOAD . ON ) ; 
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2 . 4 EXECUTIVE PROCEDURES 
2.4.1 Executive Loop 


Purpose: Describe the power on state. 


Description: When power is applied to the terminal all state is 
initialized to its default values. Input and output buffers are 
cleared and interrupts are enabled. The terminal then enters a 
loop in which it makes repeated calls to the parsing routine, 
executing events as they occur. This process continues until 
power is turned off. 


State Affected: None 


Algorithm: 

PROCEDURE EXECUTIVE. LOOP; 

BEGIN 

POWER. ON :« TRUE; 

INITIALIZE. TERMINAL ; 

INITIALIZE. PARSER (EVENT); 

WHILE POWER. ON DO 
BEGIN 

GET . NEXT . EVENT ( EVENT ) ; 

IF NOT IN. CONTROL. STRING THEN 
BEGIN 

(* check for single shifts *) 

SINGLE. SHI FT := NONE; 

WHILE (EVENT. EVENT. CODE = CONTROL . CODE ) AND 

(EVENT. CODE. VALUE = 142) OR ( EVENT . CODE .VALUE = 143) DO 
BEGIN 

CASE EVENT. CODE. VALUE OF 
142: S INGLE. SHI FT. TWO; 

143: SINGLE. SHI FT. THREE; 

END ; 

END ; 

(* then process the function *) 

CASE EVENT. EVENT. CODE OF 

GRAPHIC . CODE : INSERT . OR . REPLACE . CHARACTER ; 

CONTROL . CODE : EXECUTE . CONTROL . CODE ; 

ESCAPE. SEQUENCE: IF EVENT .VALID. SYNTAX THEN 
EXECUTE . ESCAPE . SEQUENCE ; 

CONTROL. SEQUENCE: IF EVENT.VALID. SYNTAX THEN 
EXECUTE . CONTROL . SEQUENCE ; 

DCS. INTRODUCER: IF EVENT .VALID . SYNTAX THEN 
EXECUTE. DCS. INTRODUCER SEQUENCE; 

OTHERWISE IGNORE; 
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END; 

END 

ELSE (* in control string *) 

BEGIN 

IF (EVENT. EVENT, CODE = CONTROL . CODE ) 

AND (EVENT. CODE, VALUE = 156) THEN (* String Terminator * ) 
IN, CONTROL, STRING := FALSE 

ELSE 

BEGIN 

IF REGIS, GRAPHICS. MODE « REGIS. ON THEN 

(* pass all events to ReGIS parser for processing *) 
EXECUTE, REGIS (EVENT); 

IF SIXEL. GRAPHICS, MODE = SIXEL.ON THEN 

(* pass all events to sixel parser for processing *) 
EXECUTE, SIXEL (EVENT); 

IF LOAD. DRCS. MODE = DRCS.LOAD.ON THEN 

(* pass all events to DRCS load routine for processing *) 
LOAD , DRCS ( EVENT ) ; 

IF LOAD, UDK. MODE * UDK.LOAD.ON THEN 

(* pass ail events to UDK load routine for processing *) 
LOAD, UDK (EVENT); 

END ; 

END ; 

END ; 

END; 
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2.4.2 Event Handling Tables 
2. 4. 2.1 Execute Control Code - 


Purpose: Execute valid control codes. 


Description: When a control code is received by the terminal it 
is immediately dispatched to the appropriate action routine by 
this table of 8-bit code values. 


State Affected: None 


Algorithm: 

PROCEDURE EXECUTE . CONTROL . CODE ; 

BEGIN 

CASE EVENT. CODE. VALUE OF 
7: WARNING. BELL; 

8: BACK. SPACE; 

9 : HORIZONTAL . TAB 7 

10: LINE. FEED; 

11: VERT i CAL. TAB; 

12: FORM. FEED; 

13: CARRIAGE. RETURN; 

14: SHI FT. OUT; (* Locking Shift One *) 

15: SHIFT. IN; (* Locking Shift Zero *) 

26: SUBSTITUTE; 

132: INDEX; 

133: NEXT. LINE; 

136 : HORI ZONTAL. TABULATION. SET; 

141: REVERS E. INDEX ; 

157: IN. CONTROL. STRING:* TRUE; (* Operating System Command *) 
158: IN. CONTROL. STRING:* TRUE; (* Privacy Message *) 

159: IN. CONTROL STRING:* TRUE; (* Application Program Command *) 
OTHERWISE IGNORE; 

END ; 

END; 


Known Deviations: None 
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2. 4. 2. 2 Execute Escape Sequence - 


Purpose; Execute valid escape sequences. 


Description; Escape sequences exhibiting valid syntax on 
termination are acted upon immediately upon receipt of the final 
character. The parser returns the final character code as well as 
the count of code' values of any intermediate characters received 
during processing of the sequence. 


State Affected; None 


Algorithm; 

PROCEDURE EXECUTE. ESCAPE. SEQUENCE; 

VAR N: INTEGER; 

BEGIN 

IF EVENT. INTERMEDIATE. COUNT = 0 THEN 
BEGIN 

CASE EVENT . CODE . VALUE OF 
55; SAVE. CURSOR; 

56; RESTORE. CURSOR; 

110; IF CONFORMANCE. LEVEL » LEVEL. 2 THEN LOCKING. SHIFT. TWO 
ELSE IGNORE; 

111; IF CONFORMANCE. LEVEL = LEVEL. 2 THEN LOCKING . SHIFT . THREE 
ELSE IGNORE; 

126; IF CONFORMANCE. LEVEL = LEVEL. 2 THEN 
LOCKING. SHIFT. ONE. RIGHT ELSE’ IGNORE; 

125; IF CONFORMANCE. LEVEL = LEVEL. 2 THEN 
LOCKING. SHI FT. iwO. RIGHT ELSE* IGNORE; 

124; IF CONFORMANCE. LEVEL = LEVEL. 2 THEN 

LOCKING. SHIFT. THREE. RIGHT ELSE IGNORE; 

OTHERWISE IGNORE; 

END; 

END 

ELSE 

BEGIN. 

CASE EVENT. INTERMEDIATE. COUNT OF 

1; (* three character escape sequences *) 

BEGIN 

CASE EVENT. INTERMEDIATES[1] OF 
35; (* #, 2/3 *) 

BEGIN 

CASE EVENT . CODE 1 VALUE OF 

51: DOUBLE. HEIGHT. LINE. TOP; 

52: DOUBLE. HEIGHT. LINE. BOTTOM; 

53: SINGLE. WIDTH. LINE; 

54: DOUBLE ]WIDTH^ LINE; 

OTHERWISE IGNORE; 
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END; 

END; 

32; (* SP, 2/0* *) 

BEGIN 

CASE EVENT. CODE. VALUE OF 

70: IF CONFORMANCE . LEVEL -LEVEL. 2 THEN . 

SELECT. 7. BIT. Ci. TRANSMISSION ELSE IGNORE; 
71: IF CONFORMANCE . LEVEL = LEVEL. 2 THEN 

SELECT. 8. BIT. ci. TRANSMISSION ELSE IGNORE; 
OTH ERWI S E i GNORE ; 

END; 

END; 

40,41,42,43: 

FOR N:= 1 TO 4 DO 

IF EVENT. CODE. VALUE = 

CHARACTER. SET. TABLEfN] .FINAL THEN 
DESIGNATE . CHARACTER. SET ; 

OTHERWISE IGNORE; 

END ; . 

END; 

2: (* four character escape sequences *) 

BEGIN 

IF CONFORMANCE. LEVEL - LEVEL. 2 THEN 
BEGIN 

CASE EVENT. INTERMEDIATES[1] OF 
40,41,42,43: 

IF (EVENT.INTERMEDIATES(2] = 

CHARACTER . SET . TABLE [ 4 ] . SECOND . INTERMEDIATE ) 
AND (EVENT. CODE. VALUE = 

CHARACTER. SET. TABLE[ 4] .FINAL) THEN 
DESIGNATE . CHARACTER. SET ; 

OTHERWISE IGNORE; 

END; 

END 

ELSE IGNORE; 

END; 

OTHERWISE IGNORE; 

END; 

END ; 

END ; 


Known Deviations; None 
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2. 4. 2. 3 Execute Control Sequence - 


Purpose: Execute valid control sequences. 


Description: Control sequences exhibiting valid syntax on 
termination are acted upon immediately upon receipt of the final 
character. The parser returns the final character code as well as 
the count of code values of any parameters and/or intermediate 
characters received during processing of the sequence. It also 
indicates whether a private parameter value was received. 


State Affected: None 


Algorithm: 

PROCEDURE EXECUTE . CONTROL _ SEQUENCE ; 

BEGIN 

IF EVENT. INTERMEDIATE. COUNT = 0 THEN 
BEGIN 

CASE EVENT. CODE. VALUE OF 

64: IF CONFORMANCE . LEVEL » LEVEL. 2 THEN INSERT. CHARACTER ; 
65: CURSOR. UP; 

66: CURSOR. DOWN; 

67: CURSOR ^FORWARD; 

68: CURSOR "backward; 

72: cursor] POSITION; 

74: ERASE. IN. DISPLAY; (* also Selective Erase In Display *) 
75: ERASE. IN. LINE; (* also Selective Erase In Line *) 

76: INSERT. LINE; 

77: DELETE. LINE; 

80: DELETE. CHARACTER; 

88: IF CONFORMANCE . LEVEL = LEVEL. 2 THEN ERASE. CHARACTER; 

99: DEVI CE. ATTRIBUTES ; 

102: HORIZONTAL . VERTICAL .POSITION; 

103: TABULATION.CLEAR; 

104: SET. MODE; 

105: MEDIA. COPY; 

108: RESET [mode ; 

109: SELECT. GRAPHIC. RENDITION; 

110: DEVI CE. STATUS. REPORT ; 

112: IF (EVENT. INTERMEDIATE. COUNT = 1) AND 
(EVENT. INTERMEDIATES[li » 34) THEN 
SELECT . CONFORMANCE . LEVEL ; 

113; IF ( CONFORMANCE. LEVEL = LEVEL. 2) AND 

(LEVEL 2. EXTENSIONS [SELECTIVELY ERASABLE CHARACTERS]) 

THEN 

SELECT . CHARACTER .ATTRIBUTE ; 

114: SET. TOP. AND BOTTOM MARGINS; 

OTHERWISE IGNORE; 
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END; 

I END 

I ELSE 

I { * no intermediates defined yet for control sequences *) 

I IGNORE; 

END ; 


Known Deviations: None 
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2.4.2. 4 Execute Device Control String - 

Purpose: Execute valid device control strings. 


Description: Device Control String Introducer sequences 
exhibiting valid syntax on termination are acted upon immediately 
upon receipt of the final character. The parser returns the final 
character code as well as the count of code values of any 
parameters and/or intermediate characters received during 
processing of the sequence. It also indicates whether a private 
parameter value was received. 


State Affected: None 


Algorithm: 

PROCEDURE EXECUTE. DCS INTRODUCER SEQUENCE; 

BEGIN 

IN. CONTROL. STRING:* TRUE; 

I IF EVENT. INTERMEDIATE. COUNT = 0 THEN 
I BEGIN 

CASE EVENT. CODE. VALUE OF 

112: REGIS. GRAPHICS. MODE:* REGIS. ON; 

113: SIXEL. GRAPHICS. MODE:* SIXEL.ON; 

123: LOAD. DRCS. MODE:* DRCS . LOAD . ON ; 

124: LOAD. UDK. MODE:* UDK.LOAD.ON; 

OTHERWISE IGNORE; 

END; 

I END 

I ELSE 
I IGNORE; 

I ( * no intermediates defined yet for DCS introducers *) 

END; 


Known Deviations; None 
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2.4.3 Device Attributes 


Purpose: Request device identification. 


Format: CSI Pp 0 c default Pp: none 

9/11 Pp 3/0 6/3 


Description: The DA control with a zero or omitted parameter 
prompts the terminal to return an identifying sequence in one of 
two forms, depending on the setting of the private parameter 
value, Pp. If the private parameter is omitted, the terminal will 
return a Primary Device Attributes response (see the section 
"Terminal Management" for more details on the terminal's response 
to this request). If the private parameter value is > (3/14) and 
the device is a Level 2 or higher terminal, it will return a 
Secondary Device Attributes response. 


State Affected: None 


Algorithm: 

PROCEDURE DEVICE. ATTRIBUTES; 

BEGIN 

IF EVENT . PARAMETERS [ 1 ] = 0 THEN 
BEGIN 

CASE EVENT . PRIVATE . PARAMETER OF 
0: DEVICE. ATTRIBUTES.!; 

2: DEVICE. ATTRIBUTES]2; 
OTHERWISE IGNORE; 

END; 

END 

ELSE IGNORE;. 

END; 


Known Deviations: None 
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2.4.4 Device Status Report 


Purpose; Request or report the general status of the device. 


Format ; 

CSI 

Ps 

n 

default Ps; 0 


9/11 

Ps 

6/14 



Description: The DSR control is used as an inquiry of the 

current state of the terminal device. Three levels of request are 
provided: device availability, position reporting, and printer 

availability. If the parameter value is five (5) the device will 
respond with a DSR control, the parameter of which will be one of 
the following: 

0 - Device ready, no malfunctions detected 
3 - Device not ready, malfunction detected 

If the parameter value is six (6) the device will respond with a 
Cursor Position Report (CPR) control. 

Printer status requests use the private parameter value ?15 (3/15 

3/1 3/5 ) . 

Requests for the lock status of User Defined Keys use the private 
parameter value ?25 (3/15 3/2 3/5). 

Notes; 

1. There is no guarantee of synchronization between the 
status reports transmitted by the device in response to 
this command and the actual device states at the time 
they are received by a communicating party. They are 
only indicators of the device state at the time the DSR 
control is executed by the device. 


State Affected; None 


Algorithm; 

PROCEDURE DEVICE STATUS REPORT; 
BEGIN 

CASE EVENT. PRIVATE, PARAMETER OF 
0: (* not a private *) 

BEGIN 

CASE EVENT . PARAMETERS [ 1 ] OF 
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5: REPORT. DEVICE. STATUS; 

(* see section "Terminal Management" *) 

6: CURSOR. POSITION. REPORT; 

(* see section "Character Cell Display" *) 
OTHERWISE IGNORE; 

END; . 

END ; 

1: (* private parameter *) 

BEGIN 

CASE EVENT . PARAMETERS [ 1 ] OF 
15: REPORT. PRINTER. STATUS; 

(* see section "Printer Port Extension *) 
25: REPORT. UDK. LOCK. STATUS; 

(* see section "UDK Extension *) 

OTHERWISE IGNORE; 

END ; 

END; 

OTHERWISE IGNORE; 

END; 

END; 


Known Deviations: None 



VSRM - Specification Program Structure EL-00070-02 Page 2-24 

*** COMPANY CONF - DEC Internal Use Only 18 -Mar -1985 


2.4.5 Set And Reset Modes 
2. 4. 5.1 Set Mode - 


Purpose: Place one or more mode values in the set state. 


Format: 

CSI 

Ps ; 

... ; Ps 

h 

default Ps: none 


9/11 

PS ; 

... ; Ps 

6/8 



Description: The SM control provides a means of placing one or 

more of the terminal mode values into the set state. 

Notes : 

1. The parameter list sent with a single instance of this 
control should not exceed the maximum allowable for the 
parser implementation. (Note: for a detailed 

description of the parser, see the section "Code 
Extension Layer".) 


Algorithm: 

PROCEDURE SET. MODE; 

VAR N: INTEGER; 

BEGIN 

IF EVENT. PARAMETER. COUNT = 0 THEN EVENT . PARAMETER . COUNT : = 1; 
(* check all parameters *) 

FOR N:- 1 TO EVENT. PARAMETER. COUNT DO 
BEGIN 

(* check private parameter (3/15) *) 

IF EVENT . PRIVATE . PARAMETER = 1 THEN 
BEGIN 

CASE EVENT . PARAMETERS [ N ] OF 
1: SET. CURSOR. KEY. MODE; 

3: SET. COLUMN. MODE; 

4: SET. SCROLLING. MODE; 

5: SET [screen MODE; 

6: SET.ORIGIN.MODE; 

8: SET. AUTO. REPEAT. MODE; 

18: SET.PRINT. FORM. FEED. MODE; 

19: SET .PRINT [extent. MODE; 

25: IF CONFORMANCE . LEVEL = LEVEL. 2 THEN 
SET. TEXT. CURSOR ENABLE MODE; 

OTHERWISE IGNORE; 

END; 

END 

(* check standard parameters *) 
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ELSE IF EVENT. PRIVATE. PARAMETER = 0 THEN 
BEGIN 

CASE EVENT . PARAMETERS [ N ] OF 
2: SET. KEYBOARD. ACTION. MODE; 

4: SET. INSERT. REPLACEMENT. MODE; 

20: SET. NEW LINE MODE; 

OTHERWISE IGNORE; 

END; 

END; 

END; 

END; 


Known Deviations: None 
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2.4. 5.2 Reset Mode - 


Purpose; Place one or mode values in the reset state. 


Format ; 

CSI 

Ps ; 

... ; Ps 

1 

default Ps; none 


9/11 

Ps ; 

... ; Ps 

6/12 



Description; The RM control provides a means of placing one or 
more of the terminal mode values into the reset state. 

Notes; 

1. The parameter list sent with a single instance of this 
control should not exceed the maximum allowable for the 
parser implementation (sixteen or less is recommended for 
backwards compatibility). 


Algorithm; 

PROCEDURE RESET. MODE; 

VAR N; INTEGER; 

BEGIN 

IF EVENT. PARAMETER. COUNT = 0 THEN EVENT . PARAMETER. COUNT ; = 1; 
(* check all parameters *) 

FOR N;- 1 TO EVENT . PARAMETER COUNT DO 
BEGIN 

(* check private parameter (3/15) *) 

IF EVENT. PRIVATE . Jp ARAMETER* = 1 THEN 
BEGIN 

CASE EVENT . PARAMETERS [ N ] OF 
1; RESET. CURSOR. KEY. MODE; 

3; RESET. COLUMN. MODE; 

4; RESET. SCROLLING MODE; 

5; RESET. SCREEN. MODE; 

6; RESET. ORIGIN. MODE; 

8; RESET. AUTO. REPEAT. MODE; 

18; RESET. PRINT. form' FEED. MODE; 

19; RESET. PRINT. EXTENT. MODE; 

25; IF CONFORMANCE. LEVEL - LEVEL. 2 THEN 
RESET. TEXT. CURSOR ENABLE MODE ; 

OTHERWISE IGNORE; 

END ; 

END 

(* check standard parameters *) 

ELSE IF EVENT . PRIVATE PARAMETER = 0 THEN 
BEGIN 

CASE EVENT . PARAMETERS [ N ] OF 
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2: RESET. KEYBOARD, ACTION. MODE; 

4: RESET. INSERT. REPLACEMENT. MODE; 
20: RESET. NEW. lInE. MODE; 

OTHERWISE IGNORE; 

END ; 

END; 

END; 

END; 


Known Deviations: None 
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2.5 CHANGE HISTORY 
2.5.1 Rev 0.0 To AXIO 


1. Removed ENQ, DECTST, and DECHCP from program flow 
diagram. Added ICH, ECH, DECSCA, DECSEL, and DECSED. 

2. Corrected value range for Character Type .Code from 
32.. 126 to 0..126 to permit 0 to be used to represent 
empty character positions in the display state. 

3. Removed Control _Representation_Mode from the state tables 
as well as the Set. Mode and Reset. Mode algorithms. 

4. Corrected the name of ReGIS. Graphics. Mode, and added 
Sixel .Graphics. Mode, Load. DRCS. Mode, and Load. UDK. Mode to 
the state table for Extensions. 

5. Made minor editorial corrections to the Executive Loop 
algorithm, and added code to process Single Shifts and 
the Load. DRCS and Load. UDK control strings. 

6. Removed Answerback from the Execute.Control.Code 
algorithm. Removed the processing of Single. Shift Two 
and Single. Shift. Three from this routine. 

7. Removed Hard. Copy from the Execute. Escape. Sequence 
algorithm, and changed the character set designator value 
50 to 60. 

8. Added Insert. Character , Erase. Character , and 

Select .Character. Attribute to the 

Execute.. Control .Sequence algorithm. Removed DECTST. 

9. Changed the name of Execute. Device. Control. String to 
Execute. DCS. Introducer . Sequence . 

10. Changed the escape sequence handling algorithm to support 
the character set designation scheme for DRCS which 
allows designators to be redefined dynamically. 
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2.5.2 Rev AXIO To AXll 

1. Removed Rev AXIO change bars. Added change bars to any 
change that could affect conformance or interpretation of 
the document or should be brought to the attention of 
terminal implementors or software engineers. 

2. Modified code to test intermediate count so that Control 
Sequences are uniquely recognized. 

3. Modified code to test intermediate count so that DCS 
introducer sequences are uniquely recognized. 
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3.1 INTRODUCTION 

This specification defines the form and syntax of the coded 
interchange between terminal products and other system components. 
It applies directly to serial line communications consisting of a 
stream of 7-bit or 8-bit combinations referred to as "coded 
characters". The mechanisms employed for achieving this form of 
communication, however, may be applied within the context of block 
oriented line protocols, networking packet protocols, and program 
call interfaces over high-bandwidth bus interconnects. 


3.1.1 SCOPE 

The recognition and coding of characters as described in this 
specification applies uniformly to all display terminals, printing 
terminals, computing terminals and workstations, and is 
independent of the actual character sets implemented in a 
particular terminal product. The syntax defined herein applies 
equally to the transmission and receipt of coded interchange at 
the terminal interface. 


3.1.2 NATIONAL REPLACEMENT CHARACTER SET (NRCS) EXTENSION 

Support for National Replacement Character Sets was introduced as 
an extension to the VT200 family of Digital terminals for backward 
compatibility with national versions of the VTlOO family. The 
NRCS extension allows U.S. ASCII to be replaced by one of 12 NRC 
sets corresponding to the keyboard dialect selected (when the 
keyboard dialect is other than "North American"). These 7-bit 
character sets are similar to U.S. ASCII, but replace certain 
reserved character positions with national use characters. The 
National Replacement Character Mode (DECNRCM) is intended for 
backward compatibility and restricts the terminal to 7-bit 
characters. New applications are encouraged to use one of the 
8-bit multinational character sets. See "Character Set Mode" in 
DEC STD 070-6 Video Systems Reference Manual - Keyboard 
Processing . The rest of this section of DEC STD 070 does not 
assume the NRCS Extension is present. 


3.1.3 8-BIT INTERFACE ARCHITECTURE EXTENSION 

Support for 96-character graphic character sets, ISO Latin-1 
Supplemental, and the User Preference Supplemental Set (UPSS) was 
introduced on the VT300 family of Digital terminals. The 8-bit 
Interface Architecture Extension is required for Level 3 
conformance to the Character Cell Display service class, and is 
strongly recommended (but not mandatory) for Level 2. It is also 
mandatory for Level 2 of the Character Cell Printer service class. 
The rest of this section for DEC STD 070 assumes the 8-bit 
Interface Architecture Extension is present. 


mmm 
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3.1.4 RELATIONSHIP TO TERMINAL INTERFACE ARCHITECTURE (TIA) 

Character encoding forms a part of the Code Extension Layer of the 
Terminal Interface Architecture. It is independent of any 
specific service class, and therefore applies across all products 
implementing any aspect of the architecture. 
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Figure 1. Structuring of the Terminal Interface Architecture 
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The interfaces defined within this standard apply to both internal 
and external product interfaces. External interfaces are 
interfaces between a terminal, personal computer, or workstation 
and a remote system. Internal interfaces are interfaces between a 
terminal subsystem and software processes running within a 
terminal, personal computer, or workstation. 
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Figure 2. External and Internal Terminal Interfaces 
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3 . 2 TERMINOLOGY 


bit combination - Ordered set of bits that represent a character. 

I byte - A 7-bit or 8-bit string that is used to represent control 
I or graphic information. The size of the byte is independent of 
I redundancy or framing technique. (Note: this term commonly 

I refers to the 8-bit unit.) 

character - Member of a set of elements that is used for the 
organization, control and representation of data. 

code; Coded Character Set - Set of unambiguous rules that 
establishes a character set and the one-to-one relationship 
between the characters of the set and their bit combinations. 

code extension - Techniques for the encoding of characters that 
are not included in the character set of a given code. 

code table - Table showing the character corresponding to each bit 
combination in a code. 

control character - Control function of which the coded 
representation consists of a single bit combination. 

control function - Action that affects the recording, processing, 
transmission, or interpretation of data. The coded representation 
of a control function consists of one or more bit combinations. 

control sequence - Bit string that is for control purposes in code 
extension procedures consisting of two or more bit combinations, 
beginning with a Control Sequence Introducer (CSI) control 
function, and that may contain parametric information for the 
control function. 

I control string - A string of characters that is used to perform a 
I control function and is delimited by an opening and closing 
I delimiter control. The opening delimiter is one of a small set of 
I introducer control functions (ARC, DCS, OSC, PM), and the closing 
I delimiter is String Terminator (ST). Within Digital, the syntax 
I of control strings has been extended to include an introducer 
I sequence that acts as a protocol selector and specifies how to 
I interpret subsequent control string data. 

designate - To identify a set of characters that are to be 
represented, in some cases immediately and in others upon further 
occurrence of a control function, in a prescribed manner. 

environment - The characteristic that identifies the number of 
bits used to represent a character in a data processing or data 
communication system, or in part of such a system. 

escape sequence - Bit string that is for control purposes in code 
extension procedures consisting of two or more bit combinations-, 
the first of which is an Escape (ESC) character. 
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I expansion escape sequence (Fe) - 2-character escape sequence in 
I which the final character is in columns 4 and 5, and is used to 
I extend the 7-bit code table by being the row equivalent to the 
I corresponding Cl set of controls in columns 8 and 9 of an 8-bit 
I code . 

I final character - The character whose bit combination terminates 
I an escape sequence, control sequence, or control string introducer 
I sequence . 

graphic character - Character, other than a control character, 
that has a handwritten, printed, or displayed visual 
representation and that has a coded representation consisting of 
one bit combination. 

I intermediate character - A character whose bit combination 
I precedes a Pinal character in an escape sequence, control 
I sequence, or control string introducer sequence. 

invoke - To cause a designated set of characters to be represented 
by the prescribed bit combinations whenever those bit combinations 
occur (until an appropriate code extension function occurs). 

numeric parameter - A control sequence parameter used for passing 
numeric values. 

parameter string - A character string, the bit combination of 
which occurs between the Control Sequence Introducer character and 
the first intermediate character or final character of a control 
sequence. 

position - Item in a code table identified by its column and row 
coordinates. 

represent - 1 ) To use a prescribed bit combination with the 
meaning of a character in a set of characters that has been 
designated and invoked. 2) To use an escape sequence with the 
meaning of an additional control function. 

selective parameter - A control sequence parameter used to select 
particular entries from a specified list. 
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3.3 CHARACTER CODING DESCRIPTION 
3.3.1 CHARACTER CODES 

A character code is a unique bit combination that defines a 
position in a coded character set by its column and row coordinate 
within that set. Characters may be coded using 7-bit combinations 
or 8-bit combinations. The choice of whether 7-bit or 8-bit 
character codes are used is dependent on the "width” (frame size) 
of the communications channel (referred to in this specification 
as the "environment"). 

If the channel is only seven bits wide, then only 7-bit character 
codes may be used. If the channel is eight bits wide, then either 
7-bit or 8-bit character codes may be used (7-bit character codes 
are a specific subset of the 8-bit code structure). The following 
table describes how the column and row position in the coded 
character set is derived from both 7-bit and 8-bit character 
codes. 


Bits of a 7-bit 
combination 

Bits of an 8-bit 
combination 


b7 


b6 


b5 


b4 


b3 


b2 


bl 



a6 


a5 



a2 


al 


COLUMN 


ROW 


Column and Row Reference 


3.3.2 7-BIT CHARACTER SETS 

A 7-bit coded character set has the following features. 

a. A set of 32 control characters allocated to columns 00 
and 01 (bit combinations in the range 0/0 to 1/15 
inclusive ) . 

AND EITHER 

b. A character Space (SP) in position 2/0, that may be 
regarded as either a control character or a graphic 
character . 

c. A set of 94 graphic characters allocated to columns 02 to 
07 (bit combinations from 2/1 to 7/14, inclusive). 
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d. A control character Delete (DEL) in position 7/15. 

OR 

I 

I e. A set of 96 graphic characters allocated to columns 02 to 

1 07 (bit combinations from 2/0 to 7/15, inclusive). 

I The following table describes the structure of a 7-bit coded 
1 character set including a 94-character graphic character set. 
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Figure 3. 7-bit Code Table Structure 
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3.3.3 8-BIT CHARACTER SETS 

An 8-bit coded character set has the following features. 

a. All the features of a 7-bit coded character set as 
previously listed. 

b. A set of thirty-two control characters allocated to 
columns 08 and 09, called the Cl control set (bit 
combinations from 8/0 to 9/15, inclusive). 

AND EITHER 

c. A set of 94 graphic characters allocated to columns 10 to 
15 (bit combinations from 10/1 to 15/14, inclusive), 
called the GR graphics set (for right-hand graphics set). 

OR 

d. A set of 96 graphic characters allocated to columns 10 to 
15 (bit combinations from 10/0 to 15/15, inclusive). 


Note 

2/0, 7/15, 10/0 and 15/15 are not included in CO, 
GL, Cl, or GR for 94-character graphic sets. 

2/0 and 7/15 are included in GL when a 
96-character set is invoked into GL. 

10/0 and 15/15 are included in GR when a 
96-character set is invoked into GR. 
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I The following table describes the structure of an 8-bit coded 
I character set with 94-character graphic character sets. 
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Figure 4. 8-bit Code Table Structure 
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3.3.4 CONTROL AND GRAPHIC CODES 

The coded character stream can be separated into two categories: 
control functions and coded graphic characters. Control functions 
are actions that affect the recording, processing, transmission, 
or interpretation of data. Coded graphic characters represent 
actual presentation data. All bit combinations in the coded 
character stream are specifically categorized as being either part 
of a control function or a coded graphic character. 


3. 3. 4.1 Control Characters 

A control character is a single character whose occurrence in a 
particular context initiates, modifies, or stops a control 
function. The control characters are referred to as CO and Cl. 

DEL (delete, 7/15) is also a control character, although it is not 
a member of the CO or Cl sets. SP (space, 2/0) is also not a 
member of CO or Cl, but it may be considered to be either a 
control character or a graphic character. 

In a 7-bit environment, the values of a CO control character are 
in the range of columns 00 and 01 of the code table. The Cl 
control characters are represented in 7-bit environments by 
2-character escape sequences. 

In an 8-bit environment, the values of CO control characters are 
from columns 00 and 01 and the values of Cl control characters are 
from columns 08 and 09. 


3. 3. 4. 2 Graphic Characters 

Graphic characters are characters other than a control character 
having a visual representation which is normally printed or 
I displayed. This includes all characters from the GL and GR 
I portions of the code table (2/1 to 7/14 inclusive and 10/1 to 
I 15/14 inclusive for 94 character sets; 2/0 to 7/15, inclusive and 
I 10/0 to 15/15 inclusive for 96 character sets). Graphic 

characters are frequently referred to as "printing characters". 

Bit combinations in this same range that occur within escape or 
control sequences are not treated as graphic characters, but are 
processed as part of the control function. 



TM 



EL-00070-03 

VSRM - Code Extension Layer 


14-Apr-1989 Page 3-17 

Digital Internal Use Only 


3.4 SPECIAL CHARACTERS 

I When 94-character graphic character sets are used, the following 
I characters are not part of either the control or graphic sets in a 
I 7-bit or 8-bit code, and therefore have special processing as 
I described below. 


3.4.1 2/0 (SPACE) 

I The Space character may be interpreted as a graphic character, a 
I control character, or both. As a graphic character it has the 
I visual representation of the absence of a graphic symbol. The 
Space character will be displayed using whatever display 
attributes are currently active. 


3.4.2 7/15 (DELETE) 

When received by a terminal, the Delete character is treated as an 
unimplemented control character and shall be ignored. Conforming 
software shall not use Delete as a pad character. The Delete 
character may be issued as a result of keyboard processing. Refer 
to DEC STD 070-6 for more information. 


3.4.3 10/0 

I The character code 10/0 in 8-bit environments is treated as an 
I unassigned graphic character code, and will cause the error 
1 character (usually imaged as a REVERSE QUESTION MARK) to be 
1 displayed on conforming devices. Within escape sequences and 
control sequences, the high order bit of this character will be 
ignored, and it will be treated as syntactically equivalent to 
Space ( 2/0 ) . 


3.4.4 15/15 , 

The character code 15/15 in 8-bit environments is treated as an 
unimplemented control code and shall be ignored. 
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3.5 CONTROL CODE EXTENSION TECHNIQUES 

Because the number of controls typically required for effective 
communication far exceeds the number provided in either the 7-bit 
or 8-bit code tables, special methods of providing additional 
control functions have evolved. These methods can be divided into 
three categories: escape sequences, control sequences, and 
control strings. 


3.5.1 GENERAL RULES 

3. 5. 1.1 Precedence of Control Functions 

Control characters, escape sequences, control sequences, control 
strings, and graphic characters are processed serially in the 
forward direction in the data stream with the following 
precedence: 

1. Control characters 

2. Escape sequences, control sequences, and control strings 
(equal precedence) 

3. Graphic characters 

Thus, if a control character is transmitted in the middle of an 
escape sequence, the control character is executed as if the 
escape sequence were not present (that is, as if the control 
character had been received immediately before the escape 
sequence), with the exceptions noted below. The next character 
received is assumed to be part of the escape sequence. However, 
when transmitting to a device, implementors are warned not to 
count on this property if they wish to follow the emerging ANSI 
and ISO standards that specify this as an error condition whose 
recovery is not specified. Control characters, escape sequences, 
control sequences, and control strings should not (not mandatory) 
be embedded in other escape sequences, control sequences, or 
control strings. 


3. 5. 1.2 Termination Conditions 

Escape sequences and control sequences normally terminate only on 
the receipt of a valid final character. However, there are 
certain conditions that will cause a sequence to be terminated 
without valid interpretation. In all of these cases, the 
terminated sequence is ignored. 
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3. 5. 1.2.1 Cancel 

Cancel (CAN, 1/8) is used to indicate that the data with which it 
is sent is in error or is to be disregarded. Therefore, the 
receipt of CAN causes immediate termination, without execution, of 
any sequence in progress. The CAN character itself receives no 
further processing. The characters following the CAN are not 
interpreted as part of the escape or control sequence, but rather 
are interpreted normally. 


3. 5. 1.2. 2 Substitute 

Substitute (SUB, 1/10) is used to indicate replacement of a 
character that could not be represented. The receipt of SUB 
causes immediate termination, without execution, of any sequence 
in progress. The SUB character itself, and all subsequent 
characters, are not interpreted as part of the escape or control 
sequence, but rather are interpreted normally. 


3. 5. 1.2. 3 Escape 

If an Escape (ESC, 1/11) is embedded in an escape or control 
sequence, the sequence is canceled and a new sequence begins with 
that ESC. 


3. 5. 1.2. 4 Cl Control Codes 

Since Cl control functions may be represented as ESC Fe sequences 
in 7-bit environments. Cl control characters embedded in an escape 
sequence or control sequence shall cause the sequence to be 
canceled and a new control function to begin with the Cl control 
character. This provides for compatibility between 7-bit and 
8-bit implementations. 


3. 5. 1.2. 5 Universal Terminator 

In many instances it is important that the communications link be 
set into a known state in order for conforming interchange to 
proceed. Because of the complexity of the parsing algorithms and 
rules regarding control code processing, it is desirable to 
provide a single escapement that aborts any code processing in 
progress and restore the terminal to a base state. This may be 
accomplished using the String Terminator control code, transmitted 
in its 7-bit format as ESC \ (1/11 5/12). This control terminates 
the following conditions. 
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a. Escape Sequence in Progress - The initial Escape control 
character will cause the sequence in progress to be 
canceled. The String Terminator will then be processed 
as an ESC Fe sequence (7-bit Cl control code). If no 
control string is in progress, the String Terminator will 
be ignored. 

b. Control Sequence in Progress - Same as Escape Sequence in 
Progress . 

c. Control String in Progress - If received before the Final 
Character, the control string will be treated as a 
Control Sequence in Progress. If the String Terminator 
is received after the Final Character, it causes normal 
termination of the control string. 

d. No Control Function in Progress - If a control function 
is not in progress when the String Terminator is 
received, it will be processed as an ESC Fe sequence 
(7-bit Cl control code) and will be ignored by the 
receiving party. 


NOTE 

This use of String Terminator applies to ANSI 
conforming interchange as described in this 
standard. Specific products may choose to 
implement non-ANSI modes that do not recognize 
String Terminator. Such modes should be 
documented exceptions. 


3. 5.1. 3 Unimplemented Functions 

Unimplemented functions shall be ignored as if they were not 
received. This applies to unimplemented control characters, 
escape sequences, control sequences, parameters of control 
sequences, and control strings. 

For example, unimplemented selective parameter values of control 
sequences shall be ignored as if that parameter were not received. 
Processing of the sequence shall continue with the next parameter. 
For example, if the control sequence Select Graphic Rendition 
(SGR) is sent with parameters: 1 (bold), 3 (italicized), 7 
(negative image), and 21 (doubly underlined), and the terminal 
implements bold and negative image, but does not implement 
italicized or doubly underlined, the parameters 1 and 7 shall be 
executed, and 3 and 21 shall be ignored. 
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3. 5. 1.4 Transformation Between 7-bit and 8-bit Environments 

To simplify the transformation between 7-bit and 8-bit 
environments, relaxations in constraints for the structure of 
I Control Sequences (introduced by CSI), control string introducer 
I sequences (introduced by APC, DCS, PM, and OSC), G2 sequences 
(introduced by SS2), and G3 sequences (introduced by SS3) are 
defined as follows: 

In an 8-bit code, the bit combinations of columns 10 to 15 (except 
15/15) are permitted to represent: 

a. Parameters, intermediates, and finals of a control 
sequence 

I 

I b. The contents of a control string introducer sequence 

c. The operand of a single-shift character 

In these situations, the bit combinations in the range 10/0 to 
15/15 have the same meaning as the bit combinations in the 
corresponding row from columns 02 to 07 (bit combinations in the 
range 2/0 to 7/15 inclusive). 

In a 7-bit code, the control characters Shift Out (SO, 0/14) and 
Shift In (Si, 0/15) are permitted to occur: 

a. Between the Control Sequence Introducer (CSI, 9/11) and 
the final bit combination of a control sequence 

b. Between the opening delimiter of a control string and the 
String Terminator (ST, 9/12) 

c. Between a single-shift character and its operand 

Shift Out and Shift In have no effect on the interpretation of a 
control sequence, a control string, or the operand of a single 
shift character, but may affect the meanings of sebsequent bit 
combinations in the data stream. 



TM 
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3.5.2 ESCAPE SEQUENCES 

An escape sequence is a bit string that is used for control 
purposes in code extension procedures and that consists of two or 
more bit combinations, of which the first is the bit combination 
corresponding to the Escape character (1/11). 

The general form of an escape sequence is: 

ESC I..I F 


where: 

a. ESC (Escape) is the introducer character, coded as 1/11 
in both 7-bit and 8-bit environments. 

b. I.. I are zero or more intermediate bit combinations used 
in combination with the final character to specify the 
particular function. Intermediate characters for escape 
sequences are bit combinations in the range of 2/0 to 
2/15, inclusive. 

Conforming implementations shall recognize at least three 
intermediate characters. If more intermediates than can 
be recognized are received, the entire sequence shall be 
ignored up to and including the final character. 

c. F is a final, function defining character. It is used 
either by itself or in combination with the intermediate 
characters (if any) to establish the encoded function. 
Final characters for escape sequences are bit 
combinations in the range 3/0 to 7/14 inclusive. 

d. The occurrence of bit combinations 0/0 to 1/15, 
inclusive, as well as 7/15 and 15/15 in escape sequences 
are special conditions that are handled by immediately 
executing the control function indicated, and by 
continuing processing of the escape sequence as if the 
intervening control code had not been received. Note 
that if the control code is CAN, ESC, or SUB, the 
sequence in progress is terminated. 

e. The receipt of any 8-bit Cl control character in the 
range 8/0 to 9/15, inclusive, during the processing of an 
escape sequence causes the -sequence in progress to be 
terminated. (See subhead 3. 6. 1.2. 4 under Termination 
Conditions ) 

f. Characters from columns 10 to 15 (10/0 to 15/14 
inclusive) may occur in escape sequences and have the 
same interpretation as the character from the 
corresponding row in columns 02 to 07. Thus, the 8th bit 
of graphic characters should be ignored when interpreting 
an escape sequence. 
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3. 5. 2.1 Expansion Escape Sequence ( Fe ) 

An expansion escape sequence is a special 2-character escape 
sequence ( ESC Fe ), where Fe is in columns 04 and 05 (bit 
combinations from 4/0 to 5/15 inclusive). Expansion escape 
sequences are used to expand the 7-bit code table by being 
equivalent to the 8-bit Cl control code in the row in columns 08 
and 09 corresponding to the row of the Fe character. 


3.5.3 CONTROL SEQUENCES 

A control sequence is a bit string consisting of two or more bit 
combinations, beginning with the Control Sequence Introducer 
(CSI), and that may contain parametric information for the control 
function. 

The general form of a control sequence is: 

CSI P..P I.. I F 


where: 

a. CSI is the introducer character coded as 9/11 in 8-bit 
environments and the 2-character escape sequence 1/11 
5/11 ( ESC ( ) in 7-bit environments. 

b. P..P is called the "parameter string". The minimum 
length is zero and the maximum length is defined by the 
implementation. However, all bit combinations are from 
3/0 to 3/15 inclusive. 

c. I.. I are the intermediate characters that may be used to 
expand the repertoire of functions beyond the limit of 63 
implied by the single final character value. 

Intermediate characters for control sequences are bit 
combinations in the range 2/0 to 2/15 inclusive. If 3/0 
to 3/15 occur after the occurrence of one or more 
intermediate characters, the sequence is invalid. 

However, the end of the control sequence is still defined 
by the final character. Interpretation will continue 
until a valid final character is received. 

Conforming implementations shall recognize at least three 
intermediate characters. If more intermediates than can 
be recognized are received, the entire sequence shall be 
ignored, up to and including the final character. 

d. F is a final, function defining character. It is used 
either by itself or with the intermediate characters (if 
any) to establish what function is encoded. Final 
characters are bit combinations in the range 4/0 to 7/14, 
inclusive. 


mmn 


TM 



EL-00070-03 14-Apr-1989 Page 3-24 

VSRM - Code Extension Layer Digital Internal Use Only 


e. The occurrence of bit combinations 0/0 to 1/15, 
inclusive, as well as 7/15 and 15/15 in control 
sequences, are special conditions that are handled by 
immediately executing the control function indicated, and 
continuing processing of the control sequence as if the 
intervening control code had not been received. Note 
that if the control code is CAN, ESC, or SUB, the 
sequence in progress is terminated. 

f. The receipt of any 8-bit Cl control character in the 
range 8/0 to 9/15 inclusive during the processing of a 
control sequence causes the sequence in progress to be 
terminated. (See subhead 3. 6. 1.2. 4 under Termination 
Conditions ) 

g. Characters from columns 10 to 15 (10/0 to 15/14 
inclusive) may occur in control sequences and have the 
same interpretation as the character from the 
corresponding row in columns 02 to 07. Thus, the 8th bit 
of graphic characters should be ignored when interpreting 
a control sequence. 


3. 5. 3.1 PARAMETER VALUES IN CONTROL SEQUENCES 

A parameter string consists of bit combinations from 3/0 to 3/15 
inclusive. The string represents one or more numeric or selective 
parameter values. The maximum value of each parameter is defined 
by implementation. A minimum of 16384 decimal (14 bits) is 
recommended. Parameter values larger than the maximum supported 
by an implementation should be mapped to the largest value 
supported (although this is not mandatory). 

The maximum number of parameters that can be contained in a single 
parameter string is also implementation defined; however, support 
for up to 16 parameters is required for compatibility. Parameters 
beyond the maximum number supported may be ignored. 

Each parameter value consists of zero or more bit combinations 
from 3/0 to 3/9 inclusive, representing the decimal digits 0 to 9. 
If more than one parameter value is to be supplied, the parameters 
are separated from each other by the bit combination 3/11 (ASCII 
semicolon ";"). The bit combination 3/10 is reserved for future 
standardization. If 3/10 is received within a parameter string, 
the entire sequence up to and including the final character shall 
be ignored. Bit combinations 3/12 through 3/15 are used for 
private parameter strings (see subhead 3.5. 3.4). 

In each parameter, leading bit combinations of 3/0 are not 
significant and may be omitted. A zero length parameter, or one 
consisting only of 3/0 bit combinations, represents a default 
whose value depends upon the control function. 
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Representation of a Default Parameter Value 

The latest version of ISO 6429 has instituted a 
change that permits a parameter consisting only of 
3/0 bit combinations to be treated as a parameter 
value of zero, not necessarily the default value. 

A selectable mode has been defined in the ISO 
standard that controls the interpretation of a 
parameter string consisting only of 3/0 bit 
combinations as the default value. 

This standard specifies that implementations 
continue to recognize a zero-length parameter or 
one consisting of only 3/0 bit combinations as 
representing a default value for the control 
sequence. (A small number of Digital private 
control functions violate this rule. Refer to DEC 
STD 138-0 Registry of Control Functions for 
Charac ter- Imaging Devices for further 
information. ) 


3. 5. 3. 2 NUMERIC PARAMETERS 

^7umeric parameters are used for passing numeric values. If more 
than one parameter value is supplied, the ordering of parameters 
is significant and must be preserved by the use of additional 
I separators to replace omitted parameter values. A zero or omitted 
I numeric parameter represents a default that can apply to that one 
I parameter or to the entire parameter string, depending on the 
I control function. 


3. 5. 3. 3 SELECTIVE PARAMETERS 

Selective parameters are used for selecting options from a list. 
The list of options and corresponding parameter values is defined 
by the control function. A control sequence with selective 
parameters is specified as taking either a fixed or variable 
number of selective parameters. 

If a fixed number of selective parameters is specified, the 
meaning of each parameter is determined from a separate list of 
values or actions. All of the parameters are required (or are 
assumed to be defaulted) for the particular control function to 
take effect. 

If a variable number of selective parameters is specified, each 
parameter selects a particular entry from a single list identified 
by the control. 
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In control sequences with a variable number of parameters, the 
parameters shall be processed sequentially beginning with the 
first parameter. A control sequence containing more than one such 
selective parameter shall have the same effect as a corresponding 
number of separate control sequences, each with a single 
parameter . 

For example, if Select Graphic Rendition (SGR) is sent with the 
following parameters, the resulting rendition will be negative 
image, slowly blinking, since the 0 parameter, executed after 
setting bold and underline, would return the current rendition 
value to normal. 

1 (bold) 

4 (underlined) 

0 (all attributes off) 

7 (negative image) 

5 (slowly blinking) 


3. 5. 3. 4 PRIVATE PARAMETER STRINGS 

I If a parameter string begins with a bit combination from 3/12 
I through 3/15, inclusive, the entire parameter string is subject to 
I private interpretation. This means that the control has a special 
I interpretation that is not specified in national or international 
I standards. If bit combinations 3/12 through 3/15 occur anywhere 
I else in the control sequence other than as the first character of 
I the parameter string, the entire sequence up to and including the 
I final character shall be ignored. 

Syntactically, the subsequent processing of private parameter 
strings is identical to the processing of standard parameter 
strings . 
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3. 5. 3. 5 Examples of Parameter Strings 


Table 1. Examples of Parameter Stings 


Char 

Form 

Column/row 

Form 

Explanation 


7 

3/7 


A single parameter 

value of 7 

0007 

3/0 3/0 

3/0 3/7 

A single parameter 

value of 7 

98 

3/9 3/8 


A single parameter 

value of 98 

4;2 

3/4 3/11 

3/2 

Two parameters with 

values 4 and 2 

?3 

3/12 3/3 


A private parameter 

with value of 3 

2; 

3/2 3/11 


Two parameters with 
the value 2 and the 
default value 

the first having 
second having the 

;5 

3/11 3/5 


Two parameters with the first having 
the default value and the second 
having the value 5 

l;;4 

3/1 3/11 

3/11 3/4 




Three parameters with the first 
having the value 1, the second having 
the default value, and the third 
having the value 4 

?3;4 3/15 3/3 3/11 3/4 

A private parameter string containing 
two parameter values, 3 and 4 

3;?4 3/3 3/11 3/15 3/4 


An error. The occurrence of 3/15 
as any but the first character of the 
parameter string invalidates the 
control sequence. 
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3.5.4 CONTROL STRINGS 

Control strings are a special class of control code extensions 
that provide a wide range of functions. There are four types of 
control strings, each of which has the same general structure with 
its own introducer character and internal variations. The four 
types and their formats are: 


Application Program Command 

APC 

(9/15) 

D. .D 

ST 

(9/12) 

Device Control Strings 

DCS 

(9/0) 

D. .D 

ST 

(9/12) 

Operating System Command 

OSC 

(9/13) 

D. .D 

ST 

(9/12) 

Privacy Message 

PM 

(9/14) 

D. .D 

ST 

( 9/12) 


where: 

a. ARC, DCS, OSC, or PM is the introducer character that 
starts the control string and determines its type. In 
7-bit environments, the introducer control characters are 
encoded as 1/11 5/15 (ESC _) , 1/11 5/0 (ESC P), 1/11 5/13 
(ESC ]), and 1/11 5/14 (ESC ^), respectively 

b. D..D is a command string which has a unique format for 
each control string type. However, the command string 
must be made up of characters in the range 0/8 to 0/13 
inclusive ‘and 2/0 to 7/14 inclusive. The inclusion of CO 
Controls 0/8 to 0/13 in control string data is intended 
for convenience in formating and storing control strings. 
It is recommended that these characters not affect the 
interpretation of the control string. 

c. ST is the String Terminator control character (in 7-bit 
environments ST is coded as ESC \ (1/11 5/12)). 


3. 5. 4.1 Device Control Strings 

The internal format of a Device Control String is: 


DCS P..P I.. I F D..D ST 


where : 

a. DCS is the Device Control String introducer. 

b. P..P is an optional parameter string, identical in syntax 
to the parameter string of a control sequence. 

c. I.. I is zero or more intermediate characters in the range 
2/0 to 2/15 inclusive. 
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d. F is a final, function defining character, in the range 
7/0 to 7/14 inclusive (the same as for private Control 
Sequences ) . 

e. D..D is the command string, whose format is determined by 
the combination of parameters, intermediate characters, 
and final character that precede it. 

f. ST is the String Terminator control character. 


3. 5. 4. 2 Other Control Strings 

Other control string types (Application Program Command, Operating 
System Command, and Privacy Message) are defined to have the 
following internal format. 


APC 

I . .1 

F 

D. .D 

ST 

OSC 

I. .1 

F 

D. .D 

ST 

PM 

I. .1 

F 

D. .D 

ST 


where : 

a. APC, OSC, or PM is the Control String introducer. 

b. I.. I is zero or more intermediate characters in the range 
2/0 to 2/15 inclusive.' 

c. F is a final, function defining character, in the range 
3/0 to 3/15 inclusive (the same as for private Escape 
Sequences). 

d. D..D is the command string, whose format is determined by 
the combination of intermediate characters and final 
character which precede it. 

e. ST is the String Terminator control character. 


3. 5. 4. 3 Character Strings 

Future device implementations should treat the SOS Cl control as 
the start of an unimplemented control string, although this is not 
mandatory. 

A syntax is not yet specified for the interpretation of character 
strings; the use of SOS and character strings within Digital is 
reserved for future standardization. Note that ISO may define the 
inclusion of escape and control sequences inside Character 
Strings. 


TM 
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3. 5. 4. 4 Termination Conditions 

Control strings will normally terminate upon receipt of a String 
Terminator (9/12) character. The receipt of the control 
characters . 0/8 through 0/13 is valid within control strings. For 
backward compatibility, and to minimize the effect of a lost 
String Terminator, the control codes CAN (1/8), SUB (1/10), ESC 
(1/11), or any Cl control will also terminate control strings. 

Conforming software should not depend on this practice however, 
and shall only use the String Terminator control function to 
terminate a control string. Control characters other than those 
recognized within the command string syntax may be defined to have 
other meanings in the future. It is recommended that all other 
control codes not used within a command string be ignored by 
hardware. 


3. 5. 4. 5 GR Graphic Characters Within Control Strings 

GR (8-bit) graphic characters in APC, OSC, and PM control strings 
will be treated as their 7-bit equivalent (the eighth bit will be 
ignored) . 

GR (8-bit) graphic characters are permitted within Device Control 
Strings, and the graphic character's interpretation will be 
dependent on the internal control string format. When they occur 
in the introducer sequence to a Device Control String, the eighth 
bit will be ignored, and they will be treated as their 7-bit 
equivalent. (Note that this is the same way 8-bit graphic 
characters are handled within control sequences.) 


3. 5. 4. 6 Unimplemented Control Strings 

The contents of received control strings that are not implemented 
by the receiving party will be ignored. Therefore, all data 
(control and. graphic characters) from the control string 
introducer to the string terminator (inclusive) will be discarded 
without being displayed. 



TM 
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3.5.5 PARSING ALGORITHMS 

This section describes the rules required to correctly parse a 
7-bit or 8-bit character stream, separating the control functions 
from data contained in the stream. 


Implementation Notes: 

This coding is intended to serve as a guideline to implementors 
and a clear specification of the parsing rules against which 
product certification can be performed. The code is typical of 
actual implementations, but is optimized for architectural 
clarity. It is recognized that specific implementations may alter 
the algorithms or program structure to optimize memory or 
execution speed. Such implementations must not violate the 
external functionality or rules provided by the parsing 
algorithms . 

VAX-11 C was selected as the implementation language because of 
its simplicity, portability, and wide use both inside and outside 
of Digital. 


Module Overview: 

The parser is broken into modules as follows. 


gparse.h 


Iparse .h 


global include file 

(must be included by external routines 
that call the parser) 

local include file 
(contains definitions used 
internally by the parser) 


vtparse.c parse routines 

ptexec.c parser tester executive 

Other modules not shown here include system-dependent character 
I/O routines and interrupt handling. 
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3. 5. 5.1 C Language Source Code 


/******************* module gparse.h ******************** 

* 

* Global #include file for callable re-entrant ANSI parser. 

* 

* Environment: VAX/VMS 

* Author; Peter Sichel 24-Feb-1984 

* 

* Modification history; 

* 13-NOV-1984 P. Sichel 

* added external events for control 

* string introducers APC, OSC, and PM 

* 16-May-1988 P. Sichel 

* added parse limits 

* changed default stack size to 32 

* 

*********************************************************/ 


/* parse limits */ 

#define MAX_NUM_INTERMEDIATES 3 
# define MAX_NUM_PARAMETERS 16 

# define MAX_PARAMETER_VALUE 16383 

/* parse stack */ 

♦define STACK SIZE 32 


struct parse_stack 

{ 

char index; 
unsigned char 
unsigned char 
unsigned short 
}; 


/* stack pointer */ 
class [STACK_SIZE] ; 
value [STACK_SIZE] ; 
int data [STACK SIZE]; 


/* common parse states */ 
♦define SEQ_START 0 
♦define CON_START 1 

/* external parse events */ 
♦define R PARSE ERROR 0 


♦define R_CONTINUE 1 
♦define R_GRAPHIC 2 
♦define R_CONTROL 3 
♦define R_ESC_SEQ 4 
♦define R_CSI_SEQ 5 
♦define R_DCS_SEQ 6 
♦define R_APC_SEQ 7 
♦define R_OSC_SEQ 8 
♦define R PM SEQ 9 
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/* escape sequence parser definitions */ 
/* (includes control character parser also) */ 

/* parse states */ 

/* SEQ_START 0 */ /* already defined above */ 

/* CON_START 1 */ /* already defined above */ 

idefine ES_IN_SEQ 2 
#define ES IGNORE 3 


/* control sequence parser definitions */ 


/* parse states */ 

/* SEQ_START 0 */ 

#define CS_PRIVATE 1 
#define CS_PARAM 2 
tdefine CS_INTER 3 
#define CS_IGNORE 4 

tdefine CS IGNORE P 5 


/* already defined above */ 

/* parameter value */ 

/* ignore sequence, 

but parse until final */ 

/* ignore any further parameters, 
but accept sequence if otherwise 
valid */ 
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****★★***:<?**★★**★★***** ittodulB lpdrs6«li **************** ***★ * 


* Local tinclude file for callable re-entrant ANSI parser 

* 

* Environment: VAX/VMS VAX-11 C Vl.2 

* Author: Peter Sichel 24-Feb-1984 

it 


it 

it 

it 

it 

it 

it 

it 

it 

it 

it 

it 

it 

it 

it 

it 

it 

* 

* 

* 

* 

* 


Modification history: 

2-May-1984 T. Lasko 

Fixed overlapping tdefine's in parser states 
29-May-1984 P. Sichel 

fixed pseq_parse_table to correcly 
ignore invalid sequences 
l-Jun-1984 P. Sichel 

added state CS_0MIT to indicate 
omitted parameters explicitly 
16-May-1988 P. Sichel 
removed CS_OMIT 

Added CS_IGNORE_P to ignore parameters 
beyond MAX_NUM_PARAMETERS . 

Added ES_IGNORE to ignore escape sequences 
with more than MAX_NUM_INTERMEDIATES . 

Fixed bug in parse table that would accept 
intermediates from CS_IGNORE state. 

5-Feb-1989 P. Sichel 

converted parse table data declaration. to use 
symbolic constants, and moved to module vtparse.c 
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/* state classes - used by parse executive to determine which 




parser 

to invoke */ 



♦define 

ESEQ 

0 

/* 

escape 

sequence 

*/ 

♦define 

CSI 

1 

/* 

control 

sequence 

*/ 

♦define 

DCS 

2 

/* 

control 

sequence 

*/ 

♦define 

LAST SEQ 

2 

/* 

"in sequence" marker 

♦define 

CON 

3 

/* 

control 

and graphic 


V 


/* internal parse events returned by parse_ansi() */ 


♦define 

PARSE ERROR 

0x00 

♦define 

CONTINUE 

0x10 

♦define 

GRAPHIC 

0x20 

♦define 

CONTROL 

0x30 

♦define 

ESC SEQ 

0x40 

♦define 

PAR_SEQ 

0X50 

♦define 

CANCEL 

OxDO 

♦define 

PARAM 

OxEO 

♦define 

IGNORE 

OxFO 


/* reduce a numeric parameter */ 


/* escape sequence parser definitions */ 
/* (includes control character parser also) */ 

/* parse inputs (count by number of states) */ 


tdefine ES_CONTROL 
♦define ES_INTER 
♦define ES_FINAL 
♦define ES GRAPHIC 


Z’' 


control 


0 

4 

8 

12 


sequence 


parser definitions */ 


/* parse inputs (count by number of states) */ 


♦define PI_CONTROL 0 

♦define Pl_PRIVATE 6 

♦define PI_NUMERAL 12 

♦define PI_SEMICOL 18 

♦define PI_INTER 24 

♦define PI_FINAL 30 

♦define PI OTHER 36 


m 





EL-00070-03 

VSRM - Code Extension Layer 


14-Apr-1989 Page 3-36 

Digital Internal Use Only 


★ ★**★★**** *★*★** ★ itiodtil© vtpsrs6»c **************** 


* Callable re-entrant ANSI parser. This module contains 

* the entire parser, and the action routines that alter 

* the parse state. 

* 

* Environment: VAX/VMS VAX-11 C VI. 2 

* 

* Author: Peter Sichel 24-Feb-1984 

* 


* Modified by; 

* PAS 30-May-84 

* PAS 12-NOV-84 

* 

* PAS 13-NOV-84 

* 

* PAS 16-May-88 

"k 

k 

k 


k 


k 

k 

k 

k 

*/ 


added missing "break" to switch case "IGNORE", 
modified eseq_class and pseq_class to 
recognize OxFF as a control character 
added code to recognize OSC, PM, and APC 
control strings 

Added code to test for MAX_NUM_INTERMEDIATES . 
Added code to ignore parameters beyond 
MAX_NUM_PARAMETERS . 

Added code to handle parameter values 
larger than MAX_PARAMETER_VALUE . 

Removed distinction between omitted 
and zero parameters. 

Included basic documentation in this file. 
Included parse tables in this module. 


PAS 5-Feb-89 



14-Apr-1989 Page 3-37 

Digital Internal Use Only 


EL-00070-03 

VSRM - Code Extension Layer 


I /* 

1 Introduction To VTPARSE 

1 VTPARSE is a table-driven, character re-entrant, callable parser 
I designed to recognize control functions encoded according to the 
I ANSI syntax for information interchange. The rules for encoding 
I control functions are defined in several standards including 
I ANSI 3.41, DEC STD 138-0 and DEC STD 070-3. 

I VTPARSE accepts one input character at a time (per call), and 
I recognizes the following categories of control functions when 
f they occur in the input stream. 

I o Graphic Characters 

I o CO and Cl Control Characters 

I o Escape Sequences 

1 o Control Sequences 

I o Control String Introducer Sequences including: 

I DCS, OSC, PM, and APC 


Interpreting Return Information From parse_ansi 


Parse_ansi returns with "event" set to one of the following. 


R_PARSE_ERROR 

R_CONTINUE 

R_GRAPHIC 

R_CONTROL 

R_ESC_SEQ 

R_CSI_SEQ 

R_DCS_SEQ 

R_OSC_SEQ 

R_PM_SEQ 

R APC SEQ 


parse stack, overflow, or software bug 
no event, continue parsing 
recognized a graphic character 
recognized a control character 
recognized an escape sequence 
recognized a control sequence 
recognized a DCS introducer sequence 
recognized a OSC introducer sequence 
recognized a PM introducer sequence 
recognized a APC introducer sequence 


The character or character sequence recognized is on the 
"state" stack. Parse_ansi returns two integers pointing to 
the first and final characters of the sequence on the stack. 


Each stack entry has three fields: a "class" field, a "value" 
field, and a "data" field. The possible values for these fields 
are defined in the include files "gparse.h" and "Iparse.h". 


The "class" field is used internally by the parser to determine 
which subparser to invoke (that is, the parse table to use). To 
keep the tables reasonably small, a separate table is used for 
parsing parameter sequences. 



TM 
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The "value" field is used by the parser to maintain its current 
state. The parser is a table driven finite state automata, 
where the next state and action are a function of the current 
state and input. The "value" field of the parse stack provides 
a history of what states the parser has been in and is useful 
for interpreting the contents of the parse stack. The "value" 
field may be used to identify the contents of the "data" field 
except for the final character of a sequence. The final "value" 
is usually meaningless because when a sequence is recognized, 
it is removed from the stack eliminating the need for a parse 
state. A single graphic or control character is considered both 
the start and final character of a sequence. 

The "data" field contains the actual character data input to the 
parser or a number of characters in reduced form. Examples of 
reduced forms are a single Cl control replacing an Fe sequence 
or a complete parameter value replacing a number of individual 
parameter characters. Reduced forms will always be identified 
by the contents of the "value" field. 

Examples of typical stack data are; 


value data 


final -> 

CON_START 

41 

'A' 

final -> 

CON_START 

OD 


final -> 

CON START 

41 

'A' 


ES IN SEQ 

28 

' ( ' 

start -> 

SEQ_START 

IB 

ESC 

final -> 

CS IGNORE 

68 

'h' 


CS PARAM 

3 



CS PRIVATE 

3F 

, p t 

start -> 

SEQ_START 

9B 

CSI 

final -> 

CS IGNORE 

72 

' r' 


CS PARAM 

14 



CS PARAM 

0 


start -> 

SEQ_START 

9B 

CSI 

final -> 

CS IGNORE 

72 

'p' 

start -> 

SEQ_START 

90 

DCS 

final -> 

CON START 

9C 

ST 


Errors And Exceptions 


event » R_GRAPHIC 
(the letter "A") 

event » R_CONTROL 
(carriage return) 

event » R_ESC_SEQ 
(designate UK into GO) 


event = R_CSI_SEQ 
parameter value 3 
DEC private char 
(set 132 col mode) 

event = R_CSI_SEQ 
parameter value 14(hex) 
zero or omitted parameter 
(set scroll region from 
line 1 to line 18) 

event * R_DCS_SEQ 
(begin REGIS DCS) 

event » R_CONTROL 
(string terminator) 


The parser ignores any invalid sequences it receives. 

No control function is recognized, and the parser resynchronizes 
the input stream according to the rules for error recovery in 
DEC STD 138-0. 
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To summarize: 

o ESC restarts any escape, control, or control string 
introducer sequence in progress. 

o CAN and SUB immediately cancel any escape, control, or 
control string introducer sequence in progress. SUB is 
recognized as a CO control if no sequence is in 
progress . 

o All other CO controls are immediately recognized within 
escape, control, or control string introducer sequences. 
The escape, control, or control string introducer 
sequence continues where it left off. 

o Cl controls immediately cancel any escape, control, or 
control string introducer sequence in progress. The Cl 
control is then recognized normally. This is for 7-bit 
compatibility where Cl controls are represented by two 
character Fe escape sequences. 

Two character Fe escape sequences are converted to Cl 
controls by the parser. 

o Within escape, control, and control string introducer 
sequences, eight-bit graphic codes (GR set) are 
truncated to seven-bit codes. 

o If a private parameter character (<, =, >, ?) occurs 
after the first parameter, the entire sequence will be 
ignored up to and including its final character. 

o If a parameter character occurs after the first 

intermediate character, the entire sequence will be 
ignored up to and including its final character. 

o The parser recognizes parameter values up to 
16383 (14 bits) as specified by the constant 
MAX_PARAMETER_VALUE in "gparse.h". If a parameter 
exceeds the maximum value, the parameter will be set 
_to the maximum value. 

o The parser recognizes up to 16 parameters in a 
single parameter sequence as specified by the 
constant MAX_NUM_PARAMETERS in "gparse.h". If more 
than MAX_NUM_PARAMETERS are received, parameters 
beyond the maximum number are ignored and the "value" 
field for the last parameter will be set to 
"CS_IGNORE_P" (this may be used to detect that 
parametershave been ignored). The sequence will 
still be recognized if it is otherwise valid. 
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o The parser will recognize up to three intermediate 
characters in a single escape, control, or introducer 
sequence specified by the constant MAX_NUM_INTERMEDIATES 
in "gparse.h". If more than MAX_NUM_INTERMEDIATES are 
received, the entire sequence will be ignored up to and 
including its final character. 

o DCS introducer sequences are parsed according to the 
rules for control sequences. APC, OSC, and PM 
introducer sequences are parsed according to the rules 
for escape sequences. The parser recognizes the 
introducer sequence upon receiving a valid final 
character. The parser does not keep track of whether 
a control string is in progress. Therefore it is 
possible to receive control codes, escape sequences, 
and control sequences within a control string. Handling 
of control strings must be performed at a higher level 
than the parser. 


Each intermediate character requires one stack entry. Each 
parameter value also requires one stack entry. The default stack 
size of 32 is sufficient to hold a sequence starting character, a 
private parameter character, 16 parameters, 3 intermediates, and 
still recognize nested CO control characters. If the maximum 
number of parameters or intermediates are increased, the stack 
size should be increased accordingly. If the stack overflows, 
the parser will re-initialize the stack, and return with event 
PARSE_ERROR. 

*/ 


#include "gparse.h" /*• global parse definitions */ 
tinclude "Iparse.h" /* local parse definitions */ 


/* escape sequence parse table */ 

/* eseq_parse_table[ input+f rom_state ] ==> action, to_state */ 


char eseq_parse_table [ 16 ] * 

{ 


/* 

/* 

/* 

/* 

/* 

/* 

/* 


input: ES_CONTROL */ 
from state action 


SEQ_START */ 
CON_START */ 
ES_IN_SEQ */ 
ES IGNORE */ 


CONTROL I 
CONTROL I 
CONTROL I 
CONTROL I 


to state */ 


ES_IN_SEQ, 
CON_START, 
ES_IN_SEQ, 
ES IGNORE, 


/* input: ES_INTER */ 
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/* 

/* 

/* 

f rom_state 

action 

to_state 

SEQ START */ 

CONTINUE 

1 ES IN SEQ 

/* 

CON START */ 

GRAPHIC 

j CON START 

/* 

ES IN SEQ */ 

CONTINUE 

1 ES IN SEQ 

/* 

ES IGNORE */ 

IGNORE 

1 ES_IGNORE 

/* 

input: ES FINAL */ 


/* 

from state 

action 

to state 

/* 

/* 




SEQ START */ 

ESC SEQ 

1 CON START 

/* 

CON START */ 

GRAPHIC 

1 CON START 

/* 

ES IN SEQ */ 

ESC SEQ 

1 CON START 

/* 

ES IGNORE */ 

CANCEL 

I ES_IGNORE 

/* 

input: ES GRPAHIC */ 


/* 

from state 

action 

to_state 

/* 





*/ 

*/ 

/ 

/ 


*/ 

*/ 

9 

9 

9 

9 


*/ 

*/ 


/* 

/* 

/* 

/* 


SEQ_START 
CON_START 
ES_IN_SEQ 
ES IGNORE 


*/ 

PARSE ERROR | 

i ES 

IN SEQ, 

V 

GRAPHIC j 

CON 

START, 

*/ 

PARSE ERROR j 

ES 

IN SEQ, 

*/ 

PARSE ERROR j 

ES 

IGNORE 


}; 


/* control sequense parse table */ 

/* pseq_parse_table [ input+f rom_state ] =«> action, to_state */ 

char pseq_parse_tablet 42 ] = 

{ 

/* input: PI_CONTROL */ 


/* from_state action to_state */ 

/* */ 

/* SEQ_START */ CONTROL | CS_IGNORE, 

/* CS_PRIVATE */ CONTROL j CS_IGNORE, 

/* CS_PARAM */ CONTROL j CS_IGNORE, 

/* CS_INTER */ CONTROL j CS_IGNORE, 

/* CS_IGNORE */ CONTROL j CS_IGNORE, 

/* CS_IGNORE_P */ CONTROL j CS_IGNORE_P, 

/* input: PI_PRIVATE */ 

/* from_state action to_state */ 

/* */ 

/* SEQ_START */ CONTINUE | CS_PRIVATE, 

/* CS_PRIVATE */ CONTINUE j CS_IGNORE, 

/* CS_PARAM */ CONTINUE j CS_IGNORE, 

/* CS_INTER */ CONTINUE j CS_IGNORE, 

/* CS_IGNORE */ IGNORE j CS_IGNORE, 

/* CS_IGNORE_P */ IGNORE j CS_IGNORE, 


/* input: PI_NUMERAL */ 
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/* 

/* 

f roni_state 


action 


to state * 
* 

/* 

SEQ START 

*/ 

PARAM 

1 

CS PARAM, 

/* 

CS PRIVATE 

*/ 

PARAM 

1 

CS PARAM, 

/* 

CS PARAM 

*/ 

PARAM 

1 

CS PARAM, 

/* 

CS INTER 

*/ 

CONTINUE 

1 

CS IGNORE, 

/* 

CS IGNORE 

*/ 

IGNORE 

1 

CS IGNORE, 

/* 

CS IGNORE P 

V 

IGNORE 

1 

CS_IGNORE_P 

/* 

/* 

/* 

input; PI_SEMICOL 
f rom_state 

*/ 

action 


to_state *, 

/* 

SEQ START 

*/ 

PARAM 

I 

CS PARAM, 

/* 

CS PRIVATE 

*/ 

PARAM 

1 

CS PARAM, 

/* 

CS PARAM 

*/ 

PARAM 

1 

CS PARAM, 

/* 

CS INTER 

*/ 

CONTINUE 

1 

CS IGNORE, 

/* 

CS IGNORE 

*/ 

IGNORE 

1 

CS IGNORE, 

/* 

CS IGNORE P 

*/ 

IGNORE 

1 

CS IGNORE P 


/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 


input: PI INTER */ 


f rom_state 


action 


to_state 

SEQ START. 

*/ 

CONTINUE 

1 

CS INTER, 

CS PRIVATE 

*/ 

CONTINUE 

1 

CS INTER, 

CS PARAM 

*/ 

CONTINUE 

1 

CS INTER, 

CS INTER 

*/ 

CONTINUE 

1 

CS INTER, 

CS IGNORE 

*/ 

IGNORE 

1 

CS IGNORE, 

CS IGNORE P 

*/ 

CONTINUE 

1 

CS_INTER, 

input; PI FINAL 

*/ 



f rom_state 


action 


to_state 

SEQ START 

*/ 

PAR SEQ 


1 CS IGNORE 

CS PRIVATE 

*/ 

PAR SEQ 


1 CS IGNORE 

CS PARAM 

*/ 

PAR SEQ 


1 CS IGNORE 

CS INTER 

*/ 

PAR SEQ 


1 CS IGNORE 

CS IGNORE 

*/ 

CANCEL 


1 CS IGNORE 

CS IGNORE P 

*/. 

PAR_SEQ 


1 CS_IGNORE 

input; PI OTHER 

*/ 



f rom_state 


action 


to_state 

SEQ START 

*/ 

CONTINUE 

1 

CS IGNORE, 

CS PRIVATE 

*/ 

CONTINUE 

1 

CS IGNORE, 

CS PARAM 

*/ 

CONTINUE 

1 

CS IGNORE, 

CS INTER 

*/ 

CONTINUE 

1 

CS IGNORE, 

CS IGNORE 

*/ 

IGNORE 

1 

CS IGNORE, 

CS IGNORE P 

*/ 

CONTINUE 

1 

CS IGNORE 


*/ 

*/ 


*/ 

*/ 


*/ 

*/ 


}; 


TM 
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/* shorthand for "Stack Pointer" of parse stack */ 
ttdefine SP state->index 


★ 

* parse_init - initialize parse state 

* 


parse_init ( state ) 

struct parse_stack *state; 

{ 

state->index * 0; 
state->class{ 0 ] = CON; 
state->value [ 0 ] » CON_START; 
return( 0 ) ; 

} 


* 

* parse_ansi - callable re-entrant ansi parser executive 

* 

********************************************************/ 


parse_ansi ( c , state, event, start, final) 

struct parse_stack *state; /* address of parse stack structure */ 

int c; /* input character */ 

int *event; /* event recognized (by ref) */ 

int *start; /* stack index of first char of event (by ref) */ 

int *final; /* stack index of final char of event (by ref) */ 


{ 

int action, i ; 


/* 


*/ 


/* if in sequence, convert 8 bit graphics to 7 bits */ 
if ( state->class{ SP] <= LAST_SEQ) 
if (c >= OxAO) c &* 0x7F; 


/* invoke appropriate parser based on state class */ 
switch ( state->class[ SP ] ) 

{ 

case CON; 

/* parse graphic and CONtrol characters */ 

action = parse(state, c, eseq_class ( c ) , eseq_parse_table ) ; 
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break ; 
case ESEQ: 

/* parse escape sequences */ 

action = parse(state, c, eseq_class ( c ) , eseq_parse_table ) ; 

/* check for too many intermediates */ 
i * 0 ; 

while ( state->value [ SP-i ] =» ES_IN_SEQ) 

{ 

i++ ; 

if (i > MAX_NUM INTERMEDIATES) 

{ 

/* ignore sequence (but parse until final) */ 
state->value[SP] » ES_IGNORE; 

} 

} 

break ; 

case CSI : 
case DCS: 

/* parse parameter sequence */ 

action = parse( state, c, pseq_class{ c ) , pseq_parse_table ) ; 


/* check for too many intermediates */ 
i - 0; 

while ( state->value[ SP-i ] == CS INTER) 

{ 

i++; 

if (i > MAX_NUM_INTERMEDIATES ) 

{ 

/* ignore sequence (but parse until final) */ 
state->value ( SP ] * CS_IGNORE; 

} 

} 

break ; 

} 

/* process recognized events */ 
switch (action) 

{ 

case CONTINUE: 

*event = R_CONTINUE; 
break; 

case GRAPHIC: 

*event = R_GRAPHIC; 

*start = SP; 

*final » SP; 

SP — 1; 
break ; 

case CONTROL: 

pcontrol ( state , event, start, final); 
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break ; 

case ESC_SEQ: 

pescseq( state , event, start, final); 
break ; 

case PAR_SEQ: 

♦final “ SP; 

/* find start of sequence */ 

♦start » SP; 

while ( state->value[ ♦start ] !- SEQ_START) ♦start -« 1; 
switch { state->data[ ♦start ) ) 

{ 

case 0x9B: ♦event » R_CSI_SEQ; break; 
case 0x90; ♦event - R_DCS_SEQ; break; 
default: ♦event =• R_PARSE_ERROR; break; 

} 

/♦ remove seq from parse stack, 

and return to previous parser ♦/ 

SP - ♦start - 1; 
break ; 
case PARAM; 

/♦ input was either a numeral, or a semicolon, 
reduce parameter chars to parameter value 
if current char is a numeral then 

if prev is a value, mul by 10, add current, 
range check. 

else store current as a value, 
else if current is a semicolon 


store value of zero 
if prev is not a value, 

advance stack and store a value of zero, 
finally, check for too many parameters. ♦/ 

♦event = R_C0NTINUE; 

i » SP; /♦ remember stack pointer ♦/ 
if ( state->datat SP ] 1= 0x3B) 

{ /♦ numeral ♦/ 

if ( state->value[ SP-1 ] == CS_PARAM) 

{ 

SP -= 1; 

if ( State->data(SP] > MAX_PARAMETER_VALUE/1 0 ) 
State->datatSP] » MAX_PARAMETER_VALUE ; 

else 

{ 

state->data[ SP ] ♦= 10; 

state->data[ SP j +» state->data( SP+1 ] - 0x30; 
if ( state->data[ SP] > MAX_PARAMETER_VALUE ) 
State->data[SP] = MAX_PARAMETER_VALUE ; 

} 

} 

else 

} 

else 


state->data[ SP ] 


0x30 ; 
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{ /* semicolon */ 

state->data[ SP ] = 0; 
if ( state->value [ SP-1 ] != CS_PARAM) 

{ 

SP += 1; 


state->class [ SP ] =» state->class[ SP-1 ] ; 
state->value[SP] = CS_PARAM; 
state->data( SP ] ■ 0; 

} 

} 

/* check for too many parameters */ 

if (SP >« i) /* did we add a parameter? */ 

{ 

i = 0; 


while ( state->value[ SP-i ] =« CS PARAM) 

{ 

i++ ; 

i f ( i > MAX_NUM_PARAMETERS ) 

{ 

/* ignore last parameter */ 

SP -= 1; 

/* ignore any further parameters */ 
state->value[SP] =• CS IGNORE P; 

} 

} 

} 

break ; 

case CANCEL: 

if ( state->class{ SP] <= LAST SEQ) 

{ 


while ( state->value [ SP I != SEQ_START) SP -= 1; 
SP -= 1; 

} 

*event = R_CONTINUE; 
break ; 

case IGNORE: 

*event - R_CONTINUE; 

SP — In- 
break; 
default: 

*event = R_PARSE_ERROR; 

parse_init( state ) ; /* re-initialize */ 

break; 

} /* end switch event */ 

return( *event ) ; 

} /* end routine parse_ansi */ 
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****★***★***★*********★★****★********★★**★★★****★*****★***★* 

* 

* eseq_class - return escape sequence parser input class 

* of given character. 

* 

*******************★******************************************/ 


eseq_class( c ) 
int c; 

{ 

int c_class; 

/* V 

/* determine character class */ 
if (0x20 <= c && c <=■ 0x2F) 
c_class » ES_INTER; 
else if ( (0x00 <= c && c <= OxlF) || 
(0x7F <= c && c <= 0 x 9F) I I 
(c — OxFF) ) 
c_class » ES_CONTROL; 
else if (0x30 <« c && c <» 0x7E) 
C_class « ES_FINAL; 

else 

C_class “ ES_GRAPHIC; 

return( c_class ) ; 

} 


/***************★********************************************* 

* 

* pseq_class - return parameter sequence parser input class of 

* given character. 

* 

pseq_class( c ) 
int c; 

{ 

int pi_class; 

/* V 

/* determine character class */ 
if (0x30 <» c && c <= 0x39) 
pi_class » PI_NUMERAL; 
else if (c == 0x3B) 

pi_class - PI_SEMICOL; 
else if (0x20 <» c && c <= 0x2F) 
pi_ciass * PI_INTER; 
else if (0x3C <= c && c <- 0x3F) 
pi_class = PI_PRIVATE; 
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else if (0x40 <= c && c <= 0x7E) 
pi_class ■ PI_FINAL; 
else if ( (0x00 <= c && c <- OxlF) | | 
(0x7F <“ c && c <* 0x9F) I I 
(c =» OxFF) ) 
pi_class - PI_CONTROL; 

else 

pi_class “ PI_OTHER; 

return( pi_class ) ; 

} 


/***★**★*****************★★*******★*******★* 

if 

* parse - table driven parse routine 

* 

* returns the following events: 


if 

PARSE ERROR 

if 

CONTINUE 

if 

GRAPHIC 

if 

CONTROL 

if 

ESC SEQ 

if 

CON SEQ 

if 

PARAM 

if 

CANCEL 

if 

IGNORE 

if 



* The parser is a table driven finite state automata, 

* where the next state and action are a function of 

* the current state and input. 

* 

****★****★***********************************/ 
parse( state, c, c_class, parse_table) 


Struct parse_stack *state; 

/* 

parse 

stack 

*/ 

int c; 

/* 

input 

character 

*/ 

int c_class; 

/* 

input 

class 

*/ 

char parse_table [ ] ; 

/* 

parse 

table 

*/ 


{ 


int next_action; 
int current_state ; 
int next_state; 

/*. V 

/* get next state */ 
current_state =» state->value( SP] ; 

next_state = parse_table[ c_class + current_state ] & OxOF; 
/* get action */ 

next_action = parse_table [ c_class + current state] & OxFO; 
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/* default action */ 

if (SP >- STACK_SIZE) return ( PARSE_ERROR) ; 
SP +- 1; 

state->class[SP] = state->class[ SP-1 ] ; 
state->value[ SP] = next_state; 
state->data[ SP ] » c; 

/* return action */ 
return( next_action) ; 

} /* end routine parse */ 


/***★*******★****************★★***★★****** 

* 

* pcontrol - process controls that alter 

* the parse state. 

* 

pcontrol ( state , event, start, final) 

struct parse_stack *state; 
int *event; 
int *start; 
int *final; 

{ 

int sp, code; 

/* • */ 

sp = state->index ; 
code = state->data[ sp] ; 

/* ESC */ 
if (code =» OxlB) 

{ 

/* if already in escape or control sequence, restart it */ 
if ( state->class [ sp ] <= LAST_SEQ) 

while ( state->value[ sp] != SEQ_START) sp -= 1; 
state->class( sp] » ESEQ; /* switch to escape seq parser */ 
state->value [ sp ] « SEQ_START; 
state->data[ sp] » OxlB; 
state->index - sp; 

* event » R_CONTINUE; 
return( 0 ) ; 

} 

/* CAN */ 
if (code == 0x18) 

{ 

/* if already in escape or control sequence, cancel it */ 
if ( state->class[ sp] <= LAST SEQ) 

{ 

while ( state->value( sp] != SEQ_START) sp -= 1; 
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} 

state->index * sp - 1; 

*event - R_CONTINUE; 
return( 0 ) ; 

} 

/* SUB */ 
if (code OxlA) 

{ 

/* if already in escape or control sequence, cancel it */ 
if ( state->class( sp] <= LAST_SEQ) 

{ 

while ( state->value( sp] SEQ_START) sp -= 1; 
state->index = sp-1; 


*event - R_CONTINUE; 

} 

else 

{ /* not in sequence, recognize SUB */ 

*event - R_CONTROL; 

♦start » sp; 

♦final * sp; 
state->index * sp; 

} 

return( 0 ) ; 

} 


/♦ is it a Cl control ? ♦/ 
if (code > 0x7F) 

{ 

/♦ if already in escape or control sequence, cancel it */ 
if ( state->class[ sp] <= LAST_SEQ) 

while ( state->value ( sp ] 1= SEQ_START) sp -= 1; 

/♦ CSI ♦/ 
if (code »» 0x9B) 

{ 

/♦ switch to parameter seq- parser ♦/ 
state->classt sp] = CSI; 
state->value[ sp] - SEQ_START; 
state->data( sp] * code; 
state->index = sp; 

♦event » R_CONTINUE; 
return( 0 ) ; 

} 

/♦ DCS ♦/ 

if ( code 0x90 ) 

{ 

/♦ switch to parameter seq parser ♦/ 
state->class[ sp] = DCS; 
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state->value[ sp] « SEQ_START; 
state->data[ sp] « code; 
state->index = sp; 

*event = R_CONTINUE; 
return( 0 ) ; 

} 


/* OSC, PM, APC */ 

if ( (code 0x9D) || (code 0x9E) || (code »- 0x9F) ) 

{ 

/* switch to escape sequence parser */ 
state->class[ sp] » ESEQ; 
state->value[ sp] » SEQ_START; 
state->data[ sp ] ■ code; 
state->index ■ sp; 

♦event » R_CONTINUE; 
return( 0 ) ; 

} 

} /* end Cl control */ 


/* recognize other controls */ 

♦event - R_CONTROL; 
state->data[ sp] - code; 

♦start » sp; 

♦final - sp; 

/♦ remove control character from parse stack ♦/ 
state->index - sp - 1; 
return( 0 ) ; 

} 
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/************************************* 

* 

* pescseq - process escape sequences 

* that alter the parse state. 

* 

**************************************/ 
pescseq( state , event, start, final) 

struct parse_stack *state; 
int *event; 
int *start; 
int *final; 

{ 

int sp; 

/* */ 

sp « state->index ; 

/* two character escape sequence ? */ 
if ( state->data[ sp-1 ] =« OxlB) 

{ 

/* convert 7-bit Fe sequences to Cl controls */ 
if ((0x40 <» state->data[ sp] ) && ( state->data( sp ] <* 0x5F)) 

{ 

/* store Cl control */ 

state->data[ sp-1] = state->data[ sp] + 0x40; 
state->index =» sp-1; 

/* steal code from pcontrol */ 
pcontrol ( state , event, start, final); 
return( 0 ) ; 

} 

} 

/* recognize other escape sequences */ 

/* find start of sequence */ 

while ( state->value( sp] != SEQ_START) sp -= 1; 

♦start - sp; 

♦final » state->index; 
switch ( state->data[ ♦start ] ) 

{ 

case OxlB: ♦event « R_ESC_SEQ; break; 
case 0 x 9D: ♦event = R_OSC_SEQ; break; 
case 0x9E: ♦event « R_PM_SEQ; break; 
case 0x9F: ♦event » R_APC_SEQ; break; 
default: ♦event =* R PARSE ERROR; break; 

} 

state->index = ♦start - 1; /♦ remove seq from parse stack ♦/ 

return( 0 ) ; 

} /♦ end routine pescseq ♦/ 
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********************** module ptexec.c ************** 

* This module contains the parser test executive. 

* It reads characters from the keyboard and dumps the 

* parse stack when a control function is recognized. 

* 

* Environment: VAX/VMS 

* 

* Author: Peter Sichel 24-Feb-1984 

* 

* Modification history 

* 8-May-1984 T. Lasko 

* Made (power off) cleaner. 

* 9-MAy-1984 T. Lasko 

* Fixed several protocols. 

* 13-NOV-1984 P. Sichel 

* Added OSC, PM, and APC control strings 

* 9-May-1988 P. Sichel 

* Cosmetic changes for inclusion in VSRM 
*/ 



TM 
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#include <stdio.h> 

#include "gparse.h" /* global parse definitions */ 
#include "Iparse.h" /* local parse definitions */ 

/* global storage */ 
extern int poweron; 

/* module wide storage */ 
struct parse_stack kbd_state; 

static char *eseq_state( 3 ] » 

{ 

"SEQ_START" , 

"CON_START" , 

"ES_IN_SEQ" 

}; 

static char *pseq_state[ 6 ] » 

{ 

"SEQ_START" , 

"CS_PRIVATE" , 

"CS_PARAM", 

"CS_INTER", 

"CS_IGNORE" , 

"CS IGNORE_P" 

}; 
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/******************************************* 

* ptstart( ) - 

* 

* This is the startup routine for the parser tester. 

* It simply initializes the internal state and the terminal 

* screen, then calls the executive loop, which returns when 

* we give it a "Y (power turns off). 
*★*★★★***★*★★★★**★**★★★*★*★★★★****★*★**★***★**/ 
ptstart( ) 

{ 

unsigned short n; 

/* erase screen, move cursor to home */ 
printf( "\33[2J\33(H" ) ; 

printf(''A NSI Parser Teste r\n" ) ; 
printf(" Press “Y to exit \n\n"); 

parse_init(&kbd_state) ; 

poweron - 1; /* ready....*/ 

set_passall ( ) ; 

execloop( ) ; /* gol */ 

set_nopassall ( ) ; 

return(O); /* when power off... return */ 

} 



TM 
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******************************************* 

* execloop - parser test executive 

* 

********************************************/ 

execloop( ) 

{ 

int c; 

int event, start, final, i; 

/* V 

while (poweron) 

{ 

/* get character from KEYBOARD and parse it */ 
c » readkbd( ) ; 

parse_ansi ( c , &kbd_state, sevent, sstart, &final); 

/* process recognized events */ 
switch (event) 

{ 

case R_CONTINUE: 
break ; 

case R_GRAPHIC: 

printf ( "\nR_GRAPHIC; " ) ; 

ptdump( &kbd_state , start, final); 

break ; 

case R_CONTROL: 

printf ( "\nR_CONTROL; '•) ; 

ptdump( &kbd_state , start, final); 

break; 

case R_ESC_SEQ: 

printf ( "\nR_ESC_SEQ; " ) ; 

ptdump( &kbd_state , start, final); 

break ; 

case R_CSI_SEQ; 

printf ( "\nR_CSI_SEQ; " ) ; 

ptdump( &kbd_state , start, final); 

break ; 

case R_DCS_SEQ: 

printf ( "\nR_DCS_SEQ: " ) ; 

ptdump( &kbd_state , start, final); 

break ; 

case R_OSC_SEQ: 

printf ( "\nR_OSC_SEQ; " ) ; 

ptdump( &kbd_state , start, final); 

break ; 

case R_PM_SEQ; 

printf ( "\nR_PM_SEQ; ") ; 

ptdump( &kbd_state , start, final); 

break; 



TM 
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case R_APC_SEQ: 

printf ( "\nR_APC_SEQ; " ) ; 
ptdump( &kbd_state , start, final); 
break ; 
default : 

printf ( "\nR_PARSE_ERROR; " ) ; 
ptdump( &kbd_state , start, final); 
break; 

} /* end switch case */ 

} /* while (poweron) */ 

return( 0 ) ; 

} /* end routine execloop */ 
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ieicitificitidtitic'kidcidcick-kit’kie'k-kifitifkie’k’kif'k-kic 

* ptdump - parser test stack dump 

* 

ptdump( state, start, final ) 

struct parse_stack *state; 
int start, final; 

{ 

int i ; 

for (i*start; i<*final; i++) 

{ 

printf("\n " ) ; 
switch ( state->ciass[ i ] ) 

{ 

case ESEQ: 

printf("ESEQ %-lls", eseq_state ( state->value [ i ] ] ) ; 
break ; 
case CSX : 

printf("CSI %-lls", pseq_state[ state->value( i ] ] ) ; 
break; 
case DCS: 

printf("DCS %-lls", pseq_state[ state->value( i ] ] ) ; 
break ; 
case CON: 

printf("CON %-lls", eseq_state( state->value[ i ] ] ) ; 
break; 
default: 

printf("??? %02x ", state->value [ i ] ) ; 

} 

if ( state->datat i ] < 16) printf(" %02x ", state->data[ i ] ) ; 

else printf("%4x ", state->data [ i ] ) ; 
if ((OxlF < state->data[ i ] ) && ( state->data[ i ] < 0x7F)) 
putchar ( ( int ) state->datat i ] ) ; 

} 

return ( 0 ) ; 

}; 



TM 
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3.6 GRAPHIC CODE EXTENSION TECHNIQUES 

In a 7-bit environment, the basic graphics' portion of the code 
table consists of a single 94- or 96-character set. In an 8-bit 
environment, this is supplemented with an additional 94- or 
96-character set, and the two sets are referred to as the GL set 
(left half graphics, corresponding to the single set in 7-bits), 
and the GR set (right half). In both environments, the graphic 
codes in the table can be further extended by the designation and 
invocation of a potentially unlimited repertory of graphics sets. 
This is implemented by the provision of four sets of 94 or 96 
graphic characters, referred to as the GO, Gl, G2, and G3 sets. 

Character sets may be designated to any of the four G-sets, which 
may be currently or subsequently invoiced into either the GL or GR 
positions in the code table. 


3.6.1 DESCRIPTION OF SHIFT FUNCTIONS 

Shift functions are used to invoke one of the G-sets into the left 
or right half side of the code table. There are two kinds of 
shift functions; locking shifts and single shifts. Locking 
shifts cause a G-set to be permanently invoked into the code 
table, where it will remain until another shift function occurs to 
replace it. Single shifts cause a G-set to be invoked only for 
the occurrence of the single character code following the single 
shift control in the code stream, after which the table reverts to 
its previous state before the shift occurred. 

For example, if on power-up the ASCII character set is designated 
into GO and Gl, and GO is invoked into GL, then any graphic codes 
in the GL portion of the table (2/1 through 7/14) will cause an 
ASCII character to be generated. Subsequently, the Line Drawing 
character set may be designated into Gl to replace ASCII in that 
G-set. No visible effect will occur until Gl is invoked into GL 
using a shift function. Thereafter, any GL graphic codes received 
will cause Line Drawing characters to be displayed. 
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ASCII C Supplemental_C 
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+ — ++ — + — ++ + 
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& invoke; C -> CO - ESC ! F 
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invoke ; 
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+ + + + 


-+ '++- 


GO -> GL - LSO (SI) 
G1 -> GL - LSI (SO) 
G2 -> GL = LS2, SS2 
G3 -> GL - LS3, SS3 
G1 -> GR » LSlR 
G2 -> GR - LS2R 
G3 -> GR - LS3R 
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-+ + G3 => + 
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G3 » / 


II II I I I ASCII_G - B 

I I 96 II I ... I I UPSS = < 

ar I I Char j j j j j Line_Drawing = 0 

++ I 11 ++ j ++ DEC_Supplemental = % 5 
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DRCS (as defined. 

Repertory of Graphic Character Sets 94 or 96) 

Figure 5. Designating and Invoking Control and Graphic 
Character Sets into the Eight-bit In Use Table 
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3. 6. 1.1 Locking Shifts 

Conforming terminal products will provide the following locking 
shift functions in Level 1 operation. 


Code 

Name 



G-set 

invoked 

Table 

position 

LSO * 

Locking 

Shift 

Zero 

GO 

GL 

LSI * 

Locking 

Shift 

One 

G1 

GL 

LS2 

Locking 

Shift 

Two 

G2 

GL 

LS3 

Locking 

Shift 

Three 

G3 

GL 

* Note 

- The functions 

; Locking Shift 

Zero and Locking 

Shift One 


have been previously referred to as Shift In (SI) and Shift Out 
(SO). The effect of executing these controls has not been 
changed. 


Conforming terminals will provide the following additional locking 
shift functions in Level 2 operation. 


Code 

Name 

G-set 

invoked 

Table 

position 

LSIR 

Locking Shift One Right 

G1 

GR 

LS2R 

Locking Shift Two Right 

G2 

GR 

LS3R 

Locking Shift Three Right 

G3 

GR 


The following bit combinations are not affected by the use of the 
locking shifts. 

a. Those corresponding to control characters in columns 00, 
01, 08, and 09 

b. Those corresponding to the character Space (SP) in 
position 2/0, and Delete (DEL) in position 7/15 when a 
94-character set is invoked into GL 

c. Those corresponding to positions 10/0 and 15/15 when a 
94-character set is invoked into GR 

d. Those included in any escape or control sequence (see 
notes to subheadings 3.5.2 Escape Sequences and 3.5.3 
Control Sequences for a full explanation of the use of 
bit combinations within escape and control sequences) 

e. The bit combination following a single shift function 
(SS2 or SS3) 
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3. 6. 1.2 Single Shift Functions 

Conforming terminal products will provide the following single 
shift functions in both 7-bit and 8-bit environments. 




G-set 

Table 

Code 

Name 

invoked 

position 

SS2 

Single Shift Two 

G2 

GL 

SS3 

Single Shift Three 

G3 

GL 


3.6.2 DESIGNATING CHARACTER SETS 

Each terminal shall maintain a repertory of available character 
sets, which may be designated to any of the four G-sets (note 
there is no direct way to designate a 96 character set into GO). 
Once a character set is designated to a G-set, it remains in that 
set until explicitly replaced by another character set designator. 
If the G-set is invoked into the code table at the time the 
character set is designated, it immediately replaces the existing 
set in the code table. 

Note: For a complete description of conforming software use of 

the designating and invoking controls, see DEC STD 070-1. DEC STD 
70 addresses conformance of software when communicating directly 
with a presentation device, or when writing data to a file that is 
intended only for subsequent transmission to a presentation 
device. It does not address conformance of software when 
processing terminal input or when writing data to a file that is 
intended for subsequent processing by application software. 

DEC STD 169-0 DEC Standard Coded Graphic Character Sets for 
Hardware and Software requires that when data is intended for 
subsequent processing conforming software shall not use either 
locking shift or single shift functions. This requirement is in 
fact a subset of the conformance requirements defined in this 
document, therefore the two documents do conflict. 


3.6.3 THE USER PREFERENCE SUPPLEMENTAL SET (UPSS) 

The User Preference Supplemental Set is a logical character set 
name similar in concept to a G-set (G0-G3) but at the next higher 
level. The UPSS allows one level of software indirection for 
designating supplemental character sets. The UPSS is designated 
and invoked like any other character set, but the character set 
used can be selected by the user as a SETUP option or by host 
control function in response to a user request. 

The UPSS was introduced to facilitate migration from DEC-MCS to 
ISO Latin-1. Software applications that do not need to be 
concerned with which supplemental character set is used can defer 
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the choice of a specific supplemental set to the user, thus not 
imposing a choice that might interfere with the customers 
migration plan. The designating sequence previously used for DEC 
Supplemental was changed to designate the UPSS, providing 
automatic transparent migration from DEC MCS to ISO Latin-1 for 
existing applications as soon as terminal devices can support ISO 
Latin-1 . 

The concept of a User Preference Supplemental Set also accomodates 
existing CSS Specials that used the old DEC Supplemental 
designating sequence to designate a local country specific 
character set. 

Support for the UPSS is part of the 8-bit Interface Architecture 
Extension to Level 2, and required for conformance to Level 3. As 
a minimum, the UPSS must be selectable between DEC Supplemental 
and ISO Latin-1 supplemental. The UPSS also establishes the 
initial supplemental set for display (defaults to G2 on power-up), 
and determines the keyboard supplemental character set when 8-bit 
multinational characters are enabled. See DEC STD 070-6. 


typedef enum /* upss type */ 

{ 

UPSS_DEC_SUPPLEMENTAL_G, UPSS_ISO_LATINl_SUPPLEMENTAL_G 
} upss_type; 
upss_type upss; 


3.6.4 DEFAULT DESIGNATION AND INVOCATION 

The following assignments will apply to the power-on and soft 
reset states of the terminal. 


3. 6. 4.1 Level 1 

In Level 1 operation, the default character set designations will 
be ASCII in GO, Gl , G2 , and G3 . Furthermore, the GO set (ASCII) 
will be invoked into the GL position of the In Use Table. Level 1 
operation is 7-bits only. 


3. 6. 4. 2 Level 2 (without 8-bit Interface Architecture Extension) 


In Level 2 operation, the default character set designations will 
be ASCII in GO and Gl , and the DEC Supplemental graphics set in G2 
and G3. Furthermore, the GO set (ASCII) will be invoked into the 
GL position of the In Use Table, and the G2 set (DEC Supplemental 
graphics) will be invoked into the GR position of the In Use 
Table. 
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3. 6. 4. 3 Level 3 (or Level 2 with 8-bit Interface Architecture 
Extension) 

In Level 3 operation, the default character set designations will 
be ASCII in GO and Gl, and the User Preference Supplemental Set 
(UPSS) in G2 and G3 . Furthermore, the GO set (ASCII) will be 
invoked into the GL position of the In Use Table, and the G2 set 
(UPSS, typically DEC Supplemental or ISO Latin-1 supplemental) 
will be invoked into the GR position of the In Use Table. 

Level 3 (or Level 2 with the 8-bit Interface Architecture 
Extension) also recognizes the "Announce Subset Of Code Extension 
Facilities" defined in ISO 4873 which re-initialize the designated 
and invoked character sets as described later in this chapter. 


3. 6. 4. 4 NRCS Extension 

When the NRCS Extension is present, ASCII may be replaced with a 
National Replacement Character set as a Set-Up option. In this 
case, the default character set designations will be the NRCS in 
GO, Gl , G2, and G3 , with GO in GL. National Replacement Character 
Sets are intended for backward compatibility and may be used as 
above in Level 1, Level 2, and Level 3 by selecting "7-bit NRCS 
Characters" in Set-Up or setting DECNRCM (National Replacement 
Character set Mode) from the host. Setting this mode has the side 
effect of resetting the display character sets to their default 
state as described above. Note that the NRC Mode is 7-bits only, 
GR is not available. The actual NRC set used is determined by the 
"Keyboard Dialect", and the selection of "Typewriter" or "Data 
Processing" keys. See DEC STD 070-6 for more information. 



t 
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3.7 STATE DESCRIPTIONS 

3.7.1 CONTROL SETS 

At the present time the CO and Cl control sets are fixed as the 
ANSI control sets defined in ANSI X3.4 - 1986 and ISO 6429: 1988. 

typedef enum /* cO_control_set_type */ 

{ 

ASCII_C 

} cO_control_set_type ; 

typedef enum /* cl_control_set_type */ 

{ 

SUPPLEMENTAL_C 
} cl_control_set_type ; 


3.7.2 G-SETS 


Graphic character sets are defined for each service class. (See 
DEC STD 070-5 Video Systems Reference Manual - Character Cell 
Display for a complete description of the available character sets 
and designating sequences.) The actual character sets available 
will vary for different conformance levels and extensions (NRCS, 
8-bit lA, TCS) ). Four character sets may be designated at any 
time, each into one of the four G-sets, which may be subsequently 
invoked into the In Use Table. 


typedef enum /* graphic_character_set_type */ 

{ 

ASCII_G, 

LINE_DRAWING_G , 

DEC_SUPPLEMENTAL_G , 

ISO_LATINl_SUPPLEMENTAL_G, /* 8-bit lA */ 

UPSS_G /* 8-bit lA */ 

} graphic_character_set_type ; 

graphic_character_set_type designated_graphic_sets [ 4 ] ; 


3.7.3 IN USE TABLE 

Mapping of received control functions and graphic character data 
is provided by the 8-bit code table, as described above. Since 
the 8-bit table is a superset of the 7-bit table, all references 
will be to the 8-bit table in both environments. 

typedef enum /* gset_name_type */ 

{ 

GO , Gl , G2 , G3 
} gset_name_type ; 

typedef struct /* in_use_table type */ 

{ 

cO_control_set_type cO; 


SDSGQID 
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gset_nanie_type 

cl_control_set_type 
graphic_charaGter_set_type 
gset_name_type 
} in_use_table_type; 

in_use_table_type in_use_table ; 
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gi; 

invoked_gl ; 
cl; 

gr; 

invoked_gr ; 


3.7.4 SINGLE SHIFT FUNCTIONS 

Since single shift controls affect the processing of the next 
graphic character in the received data stream, it is necessary to 
retain their occurrence until subsequent processing occurs. 

typedef enum /* single_shif t_type */ 

{ 

NONE, SS2, SS3 
} single_shift_type; 

single_shift_type single_shif t ; 


3.7.5 ENVIRONMENTS 

The environment of the host port can be selected for either a 
seven or eight bit data path in set-up. The environment of the 
printer port can be selected independently of the host environment 
as a set-up function. See DEC STD 070-7 Video Systems Reference 
Manual - Printer Port Extension . 

Note that the logical environment for which each port is set is 
independent of the actual physical hardware setting of the ports, 
and may in fact be different. For example, it may be possible to 
set the host port for an 8-bit environment, even though the 
physical channel is limited by the hardware to 7-bits. The 
architecture assumes that the physical and logical settings are 
compatible, and does not define the results when this is not the 
case. The terminal characteristics are dependent on both the 
environment and the conformance level of operation. However, 
there are only three possible states for the terminal to be in 
that this architecture specifies; 


* Level 1 operation 

7-bit graphics 
7-bit graphics 

7-bit graphics) 

* Level 2 or Level 3 operation, 7-bit Cl controls 


Host Port 


transmit - 
receive - 


7-bit controls 
7-bit controls 


(Printer Port transmit 


7-bit controls 
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Host 

Port 

transmit - 
receive - 

7- bit 

8- bit 

controls 

controls 

8-bit 

8-bit 

graphics 

graphics 

Level 

2 or 

Level 3 operation. 

8-bit 

Cl controls 


Host 

Port 

transmit - 
receive - 

8-bit 

8-bit 

controls 

controls 

8-bit 

8-bit 

graphics 

graphics 


3. 7. 5.1 Level 1 - Host Port 

Level 1 operation provides only for 7-bit communications. Thus, 
in Level 1 all control and graphic characters can only be received 
and transmitted in seven bits. The high order bit of all 8-bit 
characters received will be stripped by the terminal before any 
processing occurs. All Cl controls will be transmitted by the 
terminal as ESC Fe sequences. Only 7-bit characters will be 
generated from the keyboard (that is, attempts to generate 8-bit 
characters will fail). 


3. 7. 5. 2 Level 2 or Level 3 - Host Port 

In Level 2 or Level 3 operation both 7-bit and 8-bit 
communications are supported. The terminal will accept Cl control 
characters and GR graphic characters in both 7-bit and 8-bit Cl 
Transmission Modes. 

When 7-bit communications is selected (7-bit host port 
environment). Cl controls will only be transmitted as ESC Fe 
sequences, and only 7-bit characters will be generated from the 
keyboard (that is, attempts to generate 8-bit characters on line 
will fail ) . 

When 8-bit communications is selected (8-bit host port 
environment), the terminal can be selected to transmit Cl control 
characters either as 7-bit ESC Fe sequences, or as 8-bit control 
characters. The terminal will generate GR characters from the 
keyboard in eight bits. 

typedef enum /* environment_type */ 

{ 

SEVEN_BIT, EIGHT_BIT 
} envi ronment_type ; 

envi ronment_type 

host_port_ehvi ronment , 
printer_port_environment , 
cl transmission mode; 
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3.8 CONTROL OPERATIONS 

3.8.1 ANNOUNCE SUBSET OF CODE EXTENSION FACILITIES 
ANNOUNCE SUBSET OF CODE EXTENSION FACILITIES 


Levels; 2X, 3 (8-bit Interface Architecture Extension) 

Purpose: To indicate which subset of code extension facilities 

defined in ISO 4873 conforming interchange will use. 

Format; ESC SP <final> 

1/11 2/0 

<final> I Level of conformance 

L 4/12 I Level 1 of ISO 4873 

M 4/13 I Level 2 of ISO 4873 

N 4/14 I Level 3 of ISO 4873 


Description; This sequence announces the level of conformance 
that the subsequent interchange will conform to. Conformance to 
ISO 4873 requires some default designation and invocations on the 
part of the terminal. 

Upon receipt of a Level 1, 2, or 3 announcer sequence, the 
terminal will make the following designations and invocations; 

Level 1 

ASCII is designated into GO 

ISO Latin Alphabet Nr 1 supplemental is designated into Gl 
GO is invoked into GL 
Gl is invoked into GR 

Level 2 

ASCII is designated into GO 

ISO. Latin Alphabet Nr 1 supplemental is designated into Gl 
GO is invoked into GL 
Gl is invoked into GR 

Level 3 

ASCII is designated into GO 
GO is invoked into GL 


NOTES: 


Conformance to a subset of ISO 4873 code extension 
and interchange is NOT equivalent to the Digital 
conformance levels for Character Cell Display 
terminals. These announcer sequences and DECSCL 
both specify conformance levels, but to a 
different standard (ISO 4873 in this case). 

Any hard or soft terminal reset (receipt of RIS, 
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DECSTR, or DECSCL, or issuing the RECALL function 
from Set-Up), will cause the Terminal to reset the 
"Default Designations And Invocations" as 
described previously to conform with DEC STD 
169-0. 

Interchange conforming to ISO 4873 which issues a 
RIS, DECSTR, or DECSCL, must subsequently send an 
announcer sequence to regain the default ISO 
designations and invocations. 


State Affected: 

graphic_character_set_type 
graphic_character_set_type 
graphic_character_set_type 
gset_name_type 
g s e t_name_ty pe 


designated_graphic_sets [ 4 ] ; 

gi; 

gr; 

invoked_gl ; 
invoked_gr ; 


Algorithm: 

void announce_level 1 ( ) 

{ 

if ( ( conf ormance_level >2) || 

( level_2_extensions[ 8bi t_ia ] ) ) 

{ 

designated_graphic_sets[ 0 ] = ASCII_G,* 

designated_graphic_sets(l] =« ISO_LATINl_SUPPLEMENTAL_G; 
gl » designated_graphic_sets[ 0 ] ; 
invoked_gl = GO; 

gr = designated_graphic_sets t 1 ] ; 
invoked_gr * Gl ; 

} 

} 


void announce_level_2 ( ) 

{ 

if ( ( conformance_level > 2) || 

(level 2_extensionst8bit ia]) ) 

{ 

designated_graphic_sets[ 0 ] = ASCII_G; 

designated_graphic_sets[ 1 ] * ISO_LATINl_SUPPLEMENTAL_G; 
gl = designated_graphic_sets[ 0 ] ; 
invoked_gl = GO; 

gr = designated_graphic_sets[ 1 ] ; 
invoked_gr = Gl ; 

} 

} 

void announce_level_3 ( ) 

{ 

if ( ( conf ormance_level >2) || 

(level 2 extensions! 8bit ia]) ) 
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{ 

designated_graphic_sets [ 0 ] = ASCII_G; 
gl = designated_graphic_sets [ 0 ] ; 
invoked_gl = GO ; 

} 


Known Deviations: None 



t 
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3.8.2 COMMUNICATIONS ENVIRONMENT 

SELECT 7-BIT Cl TRANSMISSION S7C1T 

Levels: 2, 3 

Purpose: Cause the device to generate Cl controls in 7-bits as 

two character ESC Fe sequences. 


Format: 

ESC 

SP 

F 


1/11 

2/0 

4/6 


Description: The S7C1T control causes the terminal to use the 

7-bit encoding for all Cl control characters transmitted. 
Therefore, all Cl characters will be represented as two character 
ESC Fe sequences. 

Notes : 

1. The coding of this control is defined in ISO and ANSI 

standards, but is not assigned a name in those standards. 


State Affected: 

environment_type cl_transmission mode; 


Algorithm: 

void select_7_bi t_cl_transmission ( ) 

{ 

if ( conformance_level 1= LEVEL_1 ) 

cl_transmission mode = SEVEN BIT; 

} 


Known Deviations: None 
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SELECT 8-BIT Cl TRANSMISSION S8C1T 

Levels: 2, 3 

Purpose: Cause the device to generate Cl controls in 8-bits as 

single character control codes. 


Format: 

ESC 

SP 

G 


1/11 

2/0 

4/7 


Description: The S8C1T control causes the terminal to use the 

8-bit encoding for all Cl control characters transmitted. 
Therefore, all Cl characters will be represented as single 
character control codes. 

Notes: 

1. The coding of this control is defined in ISO and ANSI 
standards, but is not assigned a name in those standards. 

2. If the Host_Port_environment is set to Seven_Bit, this 
control will be ignored by the terminal. 


State Affected: 

environment_type cl_transmission_mode ; 


Algorithm: 

void select_8_bit_cl_transmission ( ) 

{ 

if ( ( conf ormance_level 1= LEVEL_1 ) && 

(host_port_environment »= EIGHT_BIT) ) 
cl_transmission_mode * EIGHT_BIT; 

} 


Known Deviations: None 
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3.8.3 SHIFT FUNCTIONS 
3. 8. 3.1 Locking Shifts 


SHIFT IN SI 

LOCKING SHIFT ZERO LSO 


Levels: 1, 2 , 3 

Purpose: Invoke the GO graphic character set into the GL position 

of the code table. 


Format: LSO (SI) 

1/15 


Description: The LSO or SI control invokes the set of graphic 

characters currently designated as a GO set into the left-hand 
graphics portion of the Code Table. Receipt of this control 
causes subsequent data in the range 2/1 through 7/14 that is 
entered into the display to be rendered according to the current 
contents of the GO character set. 

NOTE 

GO cannot normally be a 96-character set since 
there is no control function to designate a 
96-character set as GO. A 96 character UPSS could 
be designated as GO in which case subsequent data 
in the range 2/0 to 7/15 would be affected. 

Conforming software shall not designate a 96 
character UPSS as GO. 


State Affected: 

I in_use_table_type in_use_table ; 


Algorithm: 

void shift in ( ) 

{ 

in_use_table . gl = designated_graphic_sets( 0 ] ; 
in_use_table . invoked_gl * GO; 

} 


Known Deviations: 


None 
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SHIFT OUT SO 

LOCKING SHIFT ONE LSI 


Levels: 1, 2, 3 

Purpose: Invoke the Gl graphic character set into the GL position 

of the code table. 


Format: LSI (SO) 

1/14 


Description: The LSI or SO control invokes the set of graphic 

characters currently designated as a Gl set into the left-hand 
graphics portion of the Code Table. Receipt of this control 
I causes subsequent data in the range 2/1 through 7/14 (or 2/0 
I through 7/15 for 96 character sets) that is entered into the 

display to be rendered according to the current contents of the Gl 
character set. 


State Affected: 

I in_use_table_type in_use_table ; 


Algorithm: 

void shift_out ( ) 

{ 

in_use_table . gl = designated_graphic_sets [ 1 ] ; 
in_use_table . invoked_gl » Gl; 

} 


Known Deviations: None 
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LOCKING SHIFT TWO LS2 


I Levels; 2, 3 

Purpose: Invoke the G2 graphic character set into the GL position 

of the code table. 


Format: ESC n 

1/11 6/14 


Description: The LS2 control invokes the set of graphic 

characters currently designated as a G2 set into the left-hand 
graphics portion of the Code Table. Receipt of this control 
I causes subsequent data in the range 2/1 through 7/14 (or 2/0 
I through 7/15 for 96 character sets) that is entered into the 

display to be rendered according to the current contents of the G2 
character set. 

Notes: 


1. This control is included in the terminal interface for 
interchange compatibility with ISO and ANSI standards. 
It is not to be used by conforming software. 


State Affected; 

in_use_table_type in_use_table ; 


Algorithm; 

void locking_shift two ( ) 

{ 

if (conformance level LEVEL 2) 

{ 

in_use_table . gl = designated_graphic_sets [ 2 ] ; 
in_use_table . invoked_gl * G2; 

} 

} 


Known Deviations: None 
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LOCKING SHIFT THREE LS3 


I Levels; 2,3, 

Purpose: Invoke the G3 graphic character set into the GL position 

of the code table. 


Format; ESC o 

1/11 6/15 


Description; The LS3 control invokes the set of graphic 
characters currently designated as a G3 set into the left-hand 
graphics portion of the Code Table. Receipt of this control 
I causes subsequent data in the range 2/1 through 7/14 (or 2/0 
I through 7/15 for 96 character sets) that is entered into the 

display to be rendered according to the current contents of the G3 
character set. 

Notes ; 

1. This control is included in the terminal interface for 
interchange compatibility with ISO and ANSI standards. 

It is not to be used by conforming software. See DEC STD 
070-1. 


State Affected; 

in_use_table_type in_use_table ; 


Algorithm; 

void locking shift three () 

{ 

if (conformance level «« LEVEL_2 ) 

{ 

in_use_table . gl » designated_graphic_sets( 3 ] ; 
in_use_table . invoked_gl = G3 ; 

} 


Known Deviations: None 
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LOCKING SHIFT ONE RIGHT LSlR 


I Levels: 2 

Purpose: Invoke the G1 graphic character set into the GR position 

of the code table. 


Format: ESC 

1/11 7/14 


Description: The LSlR control invokes the set of graphic 

characters currently designated as a Gl set into the right-hand 
graphics portion of the Code Table. Receipt of this control 
I causes subsequent data in the range 10/1 through 15/14 (or 10/0 
I through 15/15 for 96 character sets) that is entered into the 

display to be rendered according to the current contents of the Gl 
character set. 

Notes : 

1. This control is included in the terminal interface for 
interchange compatibility with ISO and ANSI standards. 

It is not to be used by conforming software. (See DEC 
STD 070-1. ) 

2. Conformance to Level 3 of ISO 4873 requires the use of 
LSlR to invoke the right-hand part of the eight-bit code 
table . 


State Affected: 

in_use_table_type in_use_table ; 


Algorithm: 

void locking shift one right ( ) 

{ 

if ( conf ormance_level == LEVEL 2) 

{ 

in_use_table.gr « designated_graphic_sets [ 1 ] ; 
in_use_table . invoked_gr =* Gl ; 

} 


Known Deviations: None 
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LOCKING SHIFT TWO RIGHT LS2R 


I Levels: 2, 3 

Purpose: Invoke the G2 graphic character set into the GR position 

of the code table. 


Format: ESC } 

1/11 7/13 


Description: The LS2R control invokes the set of graphic 

characters currently designated as a G2 set into the right-hand 
graphics portion of the Code Table. Receipt of this control 
I causes subsequent data in the range 10/1 through 15/14 (or 10/0 
I through 15/15 for 96 character sets), that is entered into the 

display to be rendered according to the current contents of the G2 
character set. 


State Affected: 

I in_use_table_type in_use_table; 


Algorithm: 

void locking shift two right ( ) 

{ 

if ( conformance_level »» LEVEL_2 ) 

{ 

in_use_table.gr » designated_graphic_sets [ 2 ] ; 
in_use_table . invoked_gr * G2; 

} 

} 


Known Deviations: None 
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LOCKING SHIFT THREE RIGHT LS3R 


I Levels: 2, 3 

Purpose: Invoke the G3 graphic character set into the GR position 

of the code table. 


Format: ESC | 

1/11 7/12 


Description: The LS3R control invokes the set of graphic 

characters currently designated as a G3 set into the right-hand 
graphics portion of the Code Table. Receipt of this control 
I causes subsequent data in the range 10/1 through 15/14 (or 10/0 
I through 15/15 for 96 character sets) that is entered into the 

display to be rendered according to the current contents of the G3 
character set. 


State Affected: 

in_use_table_type in_use_table ; 


Algorithm: 

void locking shift three right ( ) 

{ 

if (conformance level »» LEVEL 2) 

{ 

in_use_table.gr = designated_graphic_sets[ 3 ] ; 
in_use_table . invoked_gr = G3 ; 

} 


Known Deviations: None 



EL-00070-03 

VSRM - Code Extension Layer 


14-Apr-1989 Page 3-80 

Digital Internal Use Only 


3. 8. 3^2 Single Shifts 

SINGLE SHIFT TWO SS2 


I Levels: 1, 2, 3 

Purpose: Temporarily invoke a single character from the 

designated G2 set. 


Format: SS2 

8/14 

Description: The SS2 control causes the next character in the 

received data stream., which must be in the range 2/0 through 7/15 
or 10/0 through 15/15, to be rendered according to the current 
contents of the G2 set. If the next character in the received 
data stream is not a graphic character in this range, the single 
shift function is ignored and the received character is processed 
as if the single shift had not been received. 

The only exception to this rule is that a single Shift Out (0/14) 
or Shift In (0/15) control character may occur between the Single 
I Shift and the subsequent graphic character. The Shift Out or 
I Shift In character will be interpreted normally, but does not 
I cancel the Single Shift. The following bit combination shall be 
I interpreted as a character from the G2 set. This is done for 

conformance to ISO 2022, and is intended to facilitate the design 
of 8-bit to 7-bit transformation facilities. 

State Affected: 

I single_shif t_type single_shi f t ; 

I boolean_type cancel_single_shift; 

Algorithm: 

I (See "Single Shift Three" below.) 


t 


TM 
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SINGLE SHIFT THREE SS3 


I Levels: 1, 2 , 3 

Purpose: Temporarily invoke a single character from the 

designated G3 set. 


Format: SS3 

8/15 

Description: The SS3 control causes the next character in the 

received data stream, which must be in the range 2/0 through 7/15 
or 10/0 through 15/15, to be rendered according to the current 
contents of the G3 set. If the next character in the received 
data stream is not a graphic character ‘ in this range, the single 
shift function is ignored and the received character is processed 
as if the single shift had not been received. 

The only exception to this rule is that a single Shift Out (0/14) 
or Shift In (0/15) control character may occur between the Single 
I Shift and the subsequent graphic character. The Shift Out or 
I Shift In character will be interpreted normally, but does not 
I cancel the Single Shift. The following bit combination shall be 
I interpreted as a character from the G3 set. This is done for 

conformance to ISO 2022, and is intended to facilitate the design 
of 8-bit to 7-bit transformation facilities. 


State Affected: 

1 sing-le_shif t_type single_shif t ; 

1 boolean_type cancel_single_shif t ; 

Algorithm: 

I /* . . . main loop */ 

I c = readcom( ) ; 

I parse_ansi ( c , &com_state, sevent, sstart, sfinal); 

I if ( single_shif t NONE) 

I { 

I if ( cancel_single_shif t ) single_shift =* NONE; 

I cancel_single_shif t » IS_TRUE; 

I } 


I /* process recognized events . . . */ 

I if (event == R_CONTROL) 

i { 

I code » com_state->data( final ] ; 

I if (code -= OxOE) /* SO (LSI) */ 

1 { 

I shift out ( ) ; 
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cancel_single_shift = IS_FALSE; 

} 

else if (code — OxOF) /* SI (LSO) */ 

{ 

shift_in( ) ; 

cancel_single_shif t ■ IS_FALSE; 

} 

else if (code »» 0x8E) 

{ 

single_shift » SS2; 
cancel_single_shift = IS_FALSE; 

} 

else if (code == 0x8F) 

{ 

single_shift « SS3; 

cancel single_shift » IS_FALSE; 

} 

/*...*/ 

} 

/* continue main loop . . . */ 

Known Deviations; 

Previous versions of this standard incorrectly stated that an SO 
or SI between a Single Shift and its operand would be ignored. 
Since we do not normally translate between 7-bit and 8-bit 
environments within Digital, this has not been a problem. Future 
implementations should conform to ISO 2022 as described above. 


mm 
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3.9 CHANGE HISTORY 
3.9.1 REVISION 0.2 to 0.3 


1. The standard's title was changed from "Communications and 
Coding Interchange" to "Code Extension Layer". 

2. The names of the Reference Standards were corrected. 

3. The conformance section was removed, and will later be 
integrated into the section "Concepts and Conformance 
Criteria" . 

4. The terminology section was moved from the back of the 
document to the front. 

5. A sentence was added to the section on graphic character 
codes to clarify the handling of bit combinations in the 
range 2/1 through 7/14 and 10/1 through 15/14 when 
received within a control function. 

6. Qualifications were added to the section on rate limiting 
in terminals. 

7. XON was removed from the definition of the Universal 
Terminator . 

8. Sections were added to the notes on Escape Sequences and 
Control Sequences to clarify the processing of 7/15 and 
15/15 and Cl control characters within control functions. 

9. The section on processing of control sequence parameter 
values was substantially rewritten. 

10. The section on Control Strings was moved ahead of the 
parser design. 

11. A note was added on the non-conformance of the VT125 in 
processing CAN within control strings. 

12. Global changes were made to the parser design to 
incorporate the processing of DCS introducer sequences. 

13. A figure was added showing the logical relationship of 
the C sets, G sets. In Use Table, and character sets. 

14. A note was added referencing DEC STD 169-0 and clarifying 
the distinction between conforming Presentation 
interchange and conforming Application interchange. 

15. The 8-bit locking shifts table was corrected for LS3R. 

16. All state descriptions were rewritten, and the names 
changed for consistency with other parts of the SRM. 
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17. The environments section was substantially rewritten. 

18. The default character set designations were changed to 
distinguish between Level 1 operation and Level 2 
operation. 

19. The names of Select 7-bit Cl and Select 8-bit Cl were 
changed to include "Transmission". These controls are 
now called S7C1T and S8C1T. 

20. GR Transmission Mode and Send/Receive Mode were removed 
from the architecture. 

21. The coding was changed for LSO, LSI, LSIR, LS2R, LS3R, 

SS2 and SS3. Notes were added on conforming software use 
of these controls. 

22. The character set designators were removed from this 
section and will later be incorporated into the section 
"Character Cell Display". 


3.9.2 REVISION 0.3 to AXlO 


1. Removed reference to use of Delete as a pad character, 
and made wording stronger that conforming software must 
use NUL only. 

2. Added note to description of the processing of the 10/0 
character to indicate that it is treated as Space (2/0) 
within control, functions. 

3. Made minor corrections and changed a few variable names 
in the parser algorithms to be consistent with other 
sections of the SRM. 

4. Added a note to the section on environments indicating 
that the "logical" environment might in fact be different 
from the "physical" environment of the hardware, and if 
this is the case the architecture does not define the 
result . 

5. Changed descriptions of Single_Shif t_Two and 
Single_Shif t_Three as well as the algorithms to indicate 
that they will be ignored if the next character in the 
received data stream is not a graphic character. (With 
the exception that a single Shift Out or Shift In 
character may occur.) 

6. Removed the notes which restricted conforming software 
from using Single Shift Two and Single Shift Three. 




EL-00070-03 

VSRM - Code Extension Layer 


14-Apr-1989 Page 3-85 

Digital Internal Use Only 


7. Added a note that rate limiting should be the factory 
default in devices which have a capability of defeating 
this feature. 

8. Changed the description of control characters occurring 
within control strings to permit, but deprecate the use 
of, any function other than String Terminator to 
terminate a string. 

9. Added a note that GR (8-bit) graphic characters may occur 
within control strings. 


3.9.3 REVISION AXIO to AXll 


1. Removed Rev AXIO change bars. Added change bars to any 
change that could affect conformance or interpretation of 
the document or should be brought to the attention of 
terminal implementors or software engineers. 

2. Changed GET NEXT_CODE FROM INPUT BUFFER to strip 

parity bit in Level 1. 

3. Added statement that the inclusion of CO Controls 0/8 to 
0/13 in control string data is intended for convenience 
in formating and storing control strings. It is 
recommended that these characters not affect the 
interpretation of the control string. 
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3.9.4 REVISION AXll to AX12 


1. Removed Rev AXll change bars. Added change bars to any 
change that could affect conformance or interpretation of 
the document or should be brought to the attention of 
terminal implementors or software engineers. 

2. Added description of 8-bit Interface Architecture 
Extension including Support for 96-character graphic 
character sets, ISO Latin-1 Supplemental, and the User 
Preference Supplemental Set (UPSS). The 8-bit Interface 
Architecture Extension is required for Level 3 
conformance, and strongly recommended for Level 2. 
Modified rest of chapter to assume the 8-bit Interface 
Architecture Extension is present. Graphic characters 
can now be in the range 2/0-7/15 and 10/0-15/15 when 
96-character graphic sets are used. Expanded description 
of default designations and invocations for 8-bit 
Interface Architecture. 

3. Updated referenced standards section. Added dpANS 
X3. 134. 1-1985, X3. 134. 2-1985, and ISO 8859-1:1987. 

4. Removed one page section on communication controls 
(XON/XOFF, padding, and rate limiting) because they are 
not really part of Code Extension. These will included 
in chapter 12 on Terminal Synchronization. 

5. Changed recommendation for minimum size of parameters 
that should be supported. Was 255 (8-bits), changed to 
16384 (14-bits). 

6. Added recommendation for handling parameters beyond the 
device maximum. Parameters beyond the maximum number 
supported should be ignored. 

7. Extended description of multiple selective parameters to 
conform with current usage. Not all sequences containing 
more than one selective parameter have the same effect as 
a corresponding number of separate control sequences, 
each with a single parameter. 

8. Clarified range of final characters for DCS sequences 7/0 
to 7/14 (same as for private control sequences). 

9. Added description of Digital extended syntax for other 
Control Strings (APC, OSC, PM). Syntax is patterned 
after Private Escape Sequences. 

10. Added description of Character Strings (SOS) and 
anticipatory guidelines compatible with ISO 6429. 

11. Clarified rules for 8-bit graphic characters within 
control strings including exception for DCS strings. 

8-bit graphic characters are treated as their 7-bit 
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equivalents (8th bit ignored) in APC, OSC, PM strings, 
and DCS introducer sequences. Interpretation of 8-bit 
characters in data portion of DCS strings is dependent on 
the internal control string format. 

12. Added description of NRCS Extension allowing ASCII to be 
replaced with NRC set (including default designations and 
invocations). Removed previous description of British 
NRCS as a special case. Included reference to section 6 
where DECNRCH is documented. 

13. Removed description of Printer Port Environment 

( 7-bi ts/8-bi ts ) within Host Port Environment. Added 
reference to "Printer Port Extension" chapter. 

14. Added description of "Announce Subset of Code Extension 
Facilities" per ISO 4873 including algorithm and escape 
sec[uences. 

15. Added note about the possibility of a 96-character UPSS 
being designated as GO. Normally there is no way to 
directly designate a 96-character set as GO. Conforming 
software shall not designate a 96-character UPSS as GO. 

16. Changed algorithms to use character re-entrant parser 
coded in VAX-11 C. This table driven ANSI parser is 
easier to follow, and is being used in actual products. 

Changed standard to show that SI or SO occurring between 
a Single Shift and its operand does not cancel the Single 
Shift (SS2 or SS3) but may still affect subsequent data. 


17 . 
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3.10 REFERENCED DOCUMENTS 
DIGITAL STANDARDS 


EL-00070-01 

DEC STD 070-1 Video Systems Reference 
Manual - Concepts and Conformance Criteria 

EL-00070-05 

DEC STD 070-5 Video Systems Reference 
Manual - Character Cell Display 

EL-00070-06 

DEC STD 070-6 Video Systems Reference 
Manual - Keyboard Processing 

EL-00070-07 

DEC STD 070-7 Video Systems Reference 
Manual - Printer Port Extension 

EL-00138-00 

DEC STD 138-0 Registry of Control 

Functions for Character Imaging Devices 

EL-00169-00 

DEC STD 169-0 DEC Standard Coded 

Graphic Character Sets for Hardware 
and Software 


Copies of Digital Standards Can be obtained from Standards and 
Methods Control, $ VTX SMC, JOKUR;;SMC, DTN 287-3724, or 
CTS1-2/D4. 

Please provide your name, badge number, cost center, mailstop, and 
ENET node when ordering. 


ANSI AND ISO STANDARDS 

ANSI X3 . 4 - 1986 American National Standard Code for 

Information Interchange (ASCII character set) 

ANSI X3.41 - 1974 American National Standard Code Extension 

Techniques for use with the 7-Bit Coded 
Character Set of the American National 
Standard Code for Information Interchange 

ANSI X3.64 - 1979 Additional Controls for use with American 

National Standard Code for Information 
Interchange 


ANSI X4.23 - 1982 


Keyboard Arrangement for Alphanumeric 
Machines 
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ISO 646 

ISO 2022:1986 

ISO 6429:1988 

ISO 8859-1:1987 
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8-bit ASCII Structure and Rules 

7-bit and 8-bit ASCII Supplemental 
Multinational Graphic Character Set 

Information Processing / 

7- Bit Coded Character Set 
for Information Interchange 

Information Processing / 

ISO 7-Bit and 8-Bit Coded Character Sets - 
Code Extension Techniques 

Information Processing / 

Control Functions for Coded Character Sets 

Information Processing / 

8- Bit Single-Byte Coded Character Sets - 
Part 1 : ISO Latin Alphabet Nr 1; 


Copies of ANSI and ISO Standards can be obtained from local 
Digital Libraries. 
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Section Index 


10/0, 3-17 
15/15, 3-17 

within control function, 3-22, 
3-23 

2/0, 3-17 
7/15, 3-17 

within control function, 3-22, 
3-23 

Announce Subset of Code Extension 
Facilities, 3-68 

APC 

introducer, 3-29 

Application Program Command, 3-28 

8-bit Character Set 

within control function, 3-22, 
3-24 

7- bit Characters, 3-7, 3-64 

8- bit Characters, 3-7 

Bit Combination, 3-12, 3-61 
definition, 3-10 
parameter, 3-24 
within control function, 3-16 

• C language, 3-31 
CO Control Characters, 3-60, 3-65 

7- bit encoding, 3-12 

8- bit encoding, 3-14 
CO Control Code 

within control function, 3-22, 
3-23 

Cl Control Characters, 3-60, 3-65 

7- bit encoding, 3-23, 3-71 

8- bit encoding, 3-14, 3-72 
within control functions, 3-19 
within control strings, 3-30 

Cl Control Code 

within control function, 3-22, 
3-24 

Cl Transmission Mode, 3-67, 3-71, 
3-72 

Cancel, 3-19, 3-30 
Character 
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1 INTRODUCTION 

This standard defLaes the interface to perform terminal management functions in all 
terminal devices. Terminal management functions include device control operations 
that are independent of any display service class and that are not associated with the 
presentation of data. 

1.1 SCOPE 

This standard applies to all Digital products that implement terminal management 
interfaces and are to be certified as conforming to the Terminal Interface Architecture 
(TIA). It also applies to software that is intended to use these interfaces in a conforming 
manner. 

1 .2 RELATIONSHIP TO TERMINAL INTERFACE ARCHITECTURE (TIA) 

The terminal management functions are a unique class of device controls that operate 
across layers of the TIA. 

Figure 1 : Structuring of the Ternninal Interface Architecture 
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To aid in understanding, functions described in this document are identified as intended 
for either application, terminal management, or communications use when an external 
communications interface is present (guideline). These different uses may not always be 
separated. For example, applications may require their own terminal management. If 
not otherwise indicated, functions described in this document are intended for terminal 
management use. 
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The interfaces defined within this document apply to both internal and external product 
interfaces. External interfaces are interfaces between a terminal, personal computer, or 
workstation and a remote system. Internal interfaces are interfaces between a terminal 
sub-system and software processes running -within a terminal, personal computer, or 
workstation. 


Figure 2: External and Internal Terminal Interfaces 
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2 TERMINOLOGY 

Conformance Level - An architectural agreement that defines a number of functions 
within a class of operations that must be adhered to in all products claiming to implement 
that level. Conformance levels are defined to provide interface compatibility -with other 
de-vices at the same level. Selecting a particular conformance level automatically places the 
terminal into a kno-wn state (the Soft Terminal Reset state on video terminals), -without 
affecting the data currently contained in the display. 

De-vice Self-Test - A control pro-vided as a means of invoking de-vdce specific diagnostic 
tests, and subsequently determining the de-vice status by means of the Device Status 
Report (DSR) control. 

De-vice Status Report - A control used to inquire as to the current state of tiie terminal 
de-vice. Note that some De-vice Status Reports (DSRs) are properly part of terminal 
management, while others pertain to presentation state or input processing. 

Factory Default State - Digital specified default values for all state information. Factory 
Defaults are also the initial configuration of all setable state when the unit is shipped from 
the factory (manufacturing site). 

Power-Up State - Factory defaults plus any non-volatile settings, such as Non-Volatile 
Memory (NVM), customization switches. The initial configuration of all setable state 
immediately folio-wing power-up. 
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Primary Device Attributes Control - The control used to request or report the 
implemented architectural conformance level and extensions. 

Secondary Device Attributes Control - The control used to request or report the 
identification code of the specific product in which the interface is implemented. 

Tertiary Device Attributes Control - The control used to request the identification code 
of the specific unit in which the interface is implemented. 

Terminal Management Functions - A special class of device controls that operate 
across aU layers of the Terminal Interface Architecture (TIA) and are not related to the 
presentation of data. 

3 STATE DESCRIPTIONS 

The algorithms in this standard provide a description of terminal state and how it is 
affected by various functions. They have been compiled for accuracy, but have not been 
formally certified. They should be viewed the same as other text in the standard. 

3.1 DEVICE IDENTIFICATION 

A conforming device shall provide an identification mechanism that returns the following 
information upon request. 

a. The general characteristics (display service class) of the device, indicating the 
architectural level to which the device conforms 

b. The architectural extensions that the device implements 

c. A product specific code registered by the architecture 

d. A revision level code, indicating the release level of the communicating firmware or 
software implementing the terminal management functions 

e. A list, defined by each product implementation, of product specific options installed in 
the device at the time the identification request is received 

f. For Level 4 and higher devices, a unique serial number to identify the specific unit 
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The foUowii^ example illustrates the constants used for VT420 terminal identification. 

/************** Module tenninal_identification .h *************/ 

/* 

* Constan-ts used for terminal identification 

* VT420 example 
*/ 


/* 

* Extensions to the terminal interface architecture 


* Level 1 through Level 4 
*/ 

♦define ONE_THIRTY_TWO_COLOMN 
♦define PRINTER_PORT 
♦define REGIS_GRAPHICS 
♦define SIXEL_GRAPHICS 
♦define KRTAKaNA_EXT 
♦define SELECTIVE_ERASE 
♦define DRCS_EXT 
♦define ODK_EXT 
♦define NRCS_EXT 
♦define KANJI_EXT 
♦define STATUS_DISPLAY_EXT 
♦define SERBO_CROATION 
♦define BLOCK_MODE 
♦define EIGHT_BIT_IA 
♦define TCS 
♦define LOCATOR_PORT 
♦define TSI 
♦define WINDOWING 
♦define MOLTIPLE_SESSIONS 
♦define APL 

♦define HORIZONTAL_SCROLL 
♦define COLOR_TEXT 
♦define GREEK 
♦define TURKISH 
♦define ARABIC_BILING0AL_M1 
♦define ARABIC_BILING0AL_M2 
♦define ARABIC_BILING0AL_M3 
♦define RECTANGULAR_EDITING 
♦define TEXT_LOCATOR 
♦define HANZI 

/* 

♦define TEXT_MACROS 
♦define HANGOL_HANJA 
♦define ICELANDIC 
♦define ARABIC_BILINGOAL_TC 
♦define ARABIC_BILINGDAL_NOTC 
♦define THAI 

♦define CHARACTER OUTLINING 


l-Feb-1990 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 /* Technical Char Set */ 

16 

17 /* State Interrogation */ 

18 

19 /* via TD/SMP */ 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 not assigned */ 

32 

33 

34 

35 

36 

37 

38 


♦define NUMBER OF EXTENSIONS 39 


/* device identification */ 
♦define PRODUCT_ID 41 

♦define REVISION LEVEL 10 


/* hardware options */ 
♦define NUMBER OF OPTIONS 0 


/* VT420 */ 

/* Version 1.0 times 10 */ 
/* VT420 has no options */ 
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3.2 TERMINAL STATE DECLARATIONS 

The code example below illustrates type declarations for the terminal state. TVpe 
declarations in C do not allocate any storage. All these types can be defined regardless of 
the conformance level or extensions actually implemented. 

/*★****★****★*★ Module 'beirxnlnal s'ta'te types. h ★★★*********★/ 

/* 

* type declarations for terminal state PAS l-Feb-1990 

* VT420 example 
*/ 

/* 

* terminal management 
*/ 

♦include ”terminal__identif ication .h” /* DA definitions */ 

typedef short int conf ormance__level__t; 

♦define LEVEL_1 1 

♦define LEVEL_2 2 

♦define LEVEL_3 3 

♦define LEVEL_4 4 

typedef enum 

{ /* device__status_t */ 

READY, 

MALFUNCTION 
} device_status__t; 

typedef eniim { LIMITED, UNLIMITED } transmit_^rate_limit_mode_t ; 
typedef enum 

{ /* vt__conf iguration__t */ 

SINGLE_SESSION, 

SESS IONS_ON_COMM, 

Sl_HOST_S2_PRINTER, 

S2__HOST_Sl_PRINTER 
/* VT330 with 2nd Host Port 
SESS I0NS_0N_C0MM2 , 

S1_C0MM1_S2_C0MM2 , 

S2_C0MM1_S1_C0MM2 */ 

} vt_configuration__t ; 

typedef enum 

{ /* control__representation_jmode_^t */ 

INTERPRET_CONTROLS , 

D I SP LAY_CONTROLS 

} control_representation_mode_t; 

/* • 

* Code Extension Layer 
*/ 

/* type declarations */ 

♦include "gparse.h” /* ANSI parser definitions */ 
typedef enum { ASCII^C } cO_control_set_t ; 

typedef enum { SUPPLEMENTAL^C } cl_control__set_t; 
typedef enum 

{ /* graphic__character__set__t */ 

ASCII_G, 

LINE_DRAWING_G, 

DEC__SUPPLEMENTAL_G , 

IS0_LATIN1_SUPPLEMENTAL__G, 

DRCS_G, 

NRCS_G, 

UPSS_G, 

TCS G 
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} gr aphi c__^char acts r__s e ; 
typedef enum { GO, Gl, G2, G3 } gset_^name_^t ; 
typedef struct 

{ /* in__use_table___t */ 

cO^control^set^t cO; 

graph! c__character_^set_^t gl; 

gset__name___t invoked^^gl; 


cO__control__set__t cl; 

graph! c__^char act er^set^t gr; 

gset___name_t !nvoked_gr; 

} !n_^use_table__t ; 

typedef enum { NO_SINGLE_SHIFT, SS2, SS3 ) s!ngle_^sh!ft___t ; 
typedef enum 

{ /* !n_^control_^str!ng_t */ 

NOT_IN_CONTROL_S TR ING , 

REGIS, 

SIJOIL, 

DRCS_LOAD, 

UDK_LOAD, 

MACRO_LOAD, 

TERMINAL_STATE_LOAD , 

PRESENTATION_STATE_LOAD , 

SET_TERMINAL_ONIT_ID 
} !n_control_str!ng^t; 

typedef enum { EIGHT_BIT, SEVEN__BIT ) env!ronment__t; 
typedef enum { EIGHT_BIT_MULTINATIONAL, SEVEN_BIT_NATIONAL } 
character set mode t; 


#!nclude "char_cell_types .h” /* character cell display */ 

/* 

* Status Display Extension 
*/ 

typedef enum ( MaiN_DISPLAY, STATOS_DISPLAY } active_display_t; 
typedef enum { NO_STATOS_DISPLAY, INDICATOR, HOST } 3tatus_display_t; 

/* 

* keyboard processing 
*/ 

typedef enum { UNLOCKED, LOCKED } keyboard__actlon_^mode__t ; 
typedef enum { REPEAT^ON, REPEAT__OFF } auto__repeat_mode_t; 
typedef enum { CURSOR, CK_AP PLICATION } cursor__keyjtnode_t; 
typedef enum { NUMERIC, KP__APPLI CATION } keypad_mode_t ; 
typedef enum { TYPEWRITER, DATA_PROCESSING } 
keyboard__usage_mode^t ; 

typedef enum { CAPS^LOCK, SHIFT_LOCK } caps_shlft_lock_jnode_t; 
typedef enum { HOLD^OFF, HOLD^^ON } hold_screen_mode_t; 

typedef enum { LOCK_OFF, LOCK^ON ) lock_mode_t; 

typedef enum { KEYCLICK_OFF, KEYCLICK_ON } keycllck_mode_t ; 
typedef enum { ECHO_^ON, ECHO__OFF } send__recelve__mode__t ; 

typedef enum { DELETE, BACKSPACE } backarrow_^key_mode_t; 

typedef enum { LOCAL, REPORT, IGNORE } local__key__mode__t ; 
typedef enum { L0CAL_F5, SHIFTED_ONLY, REP0RT__F5, IGN0RE_F5 } 
F5_key_mode__t ; 

typedef entim { CHARACTER, POSITION ) keyboard_^encodlng_jnode_t; 
typedef short Int keyboard^dlalect^t ; 

♦define KEYBOARD UNDEFINED 0 


♦define NORTH_AMERICAN 1 
♦define BRITISH 2 
♦define FLEMISH 3 
♦define CANADIAN_FRENCH 4 
♦define DANISH 5 
♦define FINNISH 6 
♦define GERMAN 7 
♦define DUTCH 8 
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#define 

ITALIAN 

9 

♦define 

SWISS FRENCH 

10 

♦define 

SWISS GERMAN 

11 

♦define 

SWEDISH 

12 

♦define 

NORWEGIAN 

13 

♦define 

BELGIAN FRENCH 

14 

♦define 

SPANISH 

15 

♦define 

PORTUGUESE 

16 

♦define 

CANADIAN ENGLISH 

17 

♦define 

MAX NUM DIALECTS 

18 

/* 




* printer port 
*/ 

typedef enum { PRINTER_CONTROLLER_OFF, PRINTER_CONTROLLER_ON } 
pr inter___controller___mode_t ; 

typedef enum { AUTO_PRINT_OFF, AUTO_PRINT_ON ) auto_j>rint_mode_t ; 

typedef enum { PRINT__FF__OFF, PRINT_FF_ON } print_f orm_feed_mode_t; 

typedef enum { PRINT_SCROLLING_REGION, PRINTED ISPLAY } 
pr int__extent_mode_t ; 

typedef enum { NO_PRINTER_TO_HOST, PRINTER_TO_HOST } 
printer__to_host__mode_t ; 

typedef enum { SHARED, SESSIONl, SESSI0N2 } 
printer_^assignment_t ; 

typedef enum { NATIONAL_ONLY, NATIONAL_PLUS_LINE_DRAWING, 

MULTINATIONAL_ONLY, ALL__CHARACTERS } printer_style_t ; 


/* 

* Graphics 
*/ 

typedef enum { GRAPHICS_CURSOR_ON, GRAPHICS_CURSOR_OFF } 
graphics__cursor__enable_mode__t; /* ReGIS */ 


/★*****★****★*★ module char cell types«h ★★★i^*********/ 

/* - - 

* type declarations for character cell display state 

* PAS 28-JU1-1989 
*/ 

typedef enum { JUMP, SLOW } scrolling__mode__^t ; 

typedef enum { NORMAL___SCREEN, REVERSE^SCREEN } screen_^mode_t ; 
typedef enum { WRAP_^OFF, WRAP^ON } auto_wrap_mode_t ; 
typedef enum { TEXT_CURSOR_OFF , TEXT_CURSOR__ON } 
text_cursor__enable_jnode___t ; 

typedef enum { INSERT, REPLACE } insert_replace_mode_t ; 

typedef enum { NEW_LINE_OFF, NEW_LINE_ON } new_line_mode_t ; 

typedef short int line__t; 

typedef short int column__^t; 

typedef short int page__t; 

typedef struct 

{ /* character_position__t */ 

line_t line; 
column^t column; 

page^^t page; /* L4 or Windowing */ 

} character_jposition_t ; 
typedef enum { TRUE, FALSE } boolean^t; 
typedef struct 

{ /* character__rendition_t */ 

boolean__t bold; 
boolean__t blink; 
boolean^t underscore; 
boolean__t reverse; 

) character__rendition__t; 
typedef struct 
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{ /* char act er_attribute__t */ 

boolean^^t s elect ive___er as e; 

} char act er__attribute__t; 
typedef enum 

{ /* linear endition^t */ 

DOUBLE_HEIGHT__TOP , 

DOUBLE_HE I GHT_BOTTOM , 

SINGLE_WIDTH, 

DOUBLE_WIDTH 
} line__rendition_t; 
typedef struct 

{ /* character^t */ 

short int code ; 

char act er^rendit ion_^t rendit ion ; 
character^attribute^t attribute; 
graphic_character__set_^t char act er^^set ; 

} character_t; 
typedef struct 

{ /* char__set__designator_t */ 

gr aphi eschar act e r_s e t^t name ; 

short int first^intermediate; /* 0-47, 0*no intermediate */ 

short int second__intermediate; /* 0-47 */ 

short int final; /* 0 indicates null entry */ 

} char^^s etudes ignat or^t ; 

typedef enum { ABSOLUTE, DISPLACED > originjmode_t ; 
typedef struct 

{ /* save__buffer_t */ 

character_position_^t position; 
character__rendition__t rendit ion; 
originjmode^t origin^jnode; 
graphic_^character_^set_^t left; 
graph! eschar act er__set^t right; 
graph! c_^character_set_^t gO; 
graph! c_^character_set_t gl; 
graphic__character_set__t g2 ; 
gr aphi c__char ac t e r__s e t_^t g3 ; 
character^^attribut e_^t attribute ; 

} save_buf fer^t; 

typedef enum { EIGHTY, 0NE___THIRTY_TW0 } column_mode_t ; 
typedef enum { UNCOUPLED, COUPLED } cursor__coupling_mode__^t ; 
typedef en\m { FIXED, SETABLE } left_rightjmargins_mode__t; 
typedef eniam { STREAM, RECTANGULAR } area_^extent^t ; 
typedef short int lines_per__page__t; /* 24, 25, 36, 72, 144 */ 

typedef short int columns_per_page_t ; /* 80, 132 */ 

typedef short int number_^of_pages_^t; /* 1, 2, 3, 4, 5, 6 */ 

/*******★**** end of char cell types. h ********★*******/ 
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The following example illustrates storage declarations for the terminal state. Only those 
state variables required for the desired conformance level and extensions need be present. 


/*★*****★**★*★* Module 'bermlnal st.at.e ex'bernoh ***T*f**T»r'******/ 
/* - - 

* external storage declarations for terminal state 

* VT420 example PAS 28-Feb-1989 

*/ 

/* 

* This code can also used to allocate storage 

* by redefining "ext” to be null. 

*/ 

fdefine ext extern 

#include "terminal's tat e__types .h" 

/* 

* terminal management 
*/ 

ext conformance^level^t conformance^^level; 
ext boolean^t leve l_l_extens ions [NUMBER__OF__EXTENS IONS] / 
ext boolean_t le vel_2_extens ions [ NUMBER_OF_EXTENS IONS] ; 
ext boolean^^t leve l_3_extens ions (NUMBER__OF_EXTENS IONS] ; 
ext boolean^t leve l_4__extens ions [NUMBER_OF__EXTENS IONS] / 

/* VT420 has no options — 

ext boolean__t product_options [NUMBER_OF_^OPTIONS] ; 

“*/ 

ext long int terminal__unit_id; /* Level 4, VT420 example */ 
ext device^status^t device^^status; 

ext transmit__rate_^limit_mode_t transmit___rate_limit_mode; 

ext boolean^t power___up_^detected__flag/ /* Level 4 */ 

ext boolean^t error_detected__f lag; /* Level 4 */ 

ext vt^configuration^t vt^^conf iguration; /* session mgmt ext '^/ 

ext control_representation_mode_t 

control__^representation__mode; /* Set-Up */ 

ext boolean__^t line___localjmode; /* Set-Up */ 

/* 

* Code Extension Layer 
*/ 

ext struct parse^stack coiwn 
ext graphic_character__set__t 
ext in_use_t ablest 
ext single__shift_t 
ext in_control_string___t 
ext graphic___character___set__t 
ext char act er__set__mode_t 
ext char act er_^set_^mode___t 
ext environment^t 

host_port_environment , 
cl^transmission^^mode; 

tinclude "char_cell___extern .h” /* character cell display */ 


state; /* ANSI parser state */ 

designated_^graphic__sets [4] ; 
in^use^^table; 
s ingle_^shif t ; 
in_cont rol^st ring ; 

upss; /* Level 3 or 8-bit lA */ 
character__set_mode ; 
r character set mode; 
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/* 

* 

*/ 

ext 

ext 

ext 

ext 

ext 

ext 

ext 

ext 

ext 

ext 

ext 

ext 

ext 


keyboard processing 

keyboar d__act i on jmode__t 

auto_repeat_mode_t 

cur s or__^k ey_jnode___t 

keypad_mode_t 

keyb oar d_^u s age^mode^t 

caps^shi f t_lock_mode__t 

ho ld_s cr een__mode___t 

lock_mode__t 

key c 1 i ck_mode__t 

send^receivejmode__^t 

s e nd^^r e c e i ve_jnode__t 

backarrow_key_mode_t 

local_key_mode_t 

compose_^key_mode , 
alt^keyjmode , 
Fl^^key, 

F2_key, 

F3__key, 

F4__key; 
FS^key^mode^t 


keyboard__act ion_jnode ; 
auto_repeat__mode ; 
cursor__key_mode ; 
keypad^jmode ; 
keyboard_usage_jnode ; 
cap s__^s hi f t^l oc k_jmode ; 
hold_screen_^mode ; 
lock^mode ; 
keyclick_jnode ; 
send^^r ecei ve^mode ; 
r_^send_recei ve^mode ; 
backarrow__key_jtnode ; 


/* Level 3 */ 


/* 


ext FS^key^mode^t F5_key_jnode; 

ext keyboard^encoding^mode^t keyboard__encoding_jnode; 
ext keyboard^dialect^^t keyboard^dialect ; 

ext graphic^character^set^t nrcs^list [MAX_NUM_DIALECTS] 


Level 3 */ 
Level 4 */ 




Level 4 */ 
Level 4 */ 
/* NRCS 
7* NRCS */ 


/* 

* printer port extension 

*/ 

ext print er^controllerjmode_^t 
ext auto^rint^mode^t 
e xt pr int__^f o rm^f ee d_mode__t 
ext print^^extent^mode^t 
ext printer_^to_^host_mode__^t 
ext printer__assignment__t 
ext environment^t 
ext printer^style^t 


print er^controller__mode ; 
auto__print_mode ; 
pr int_^f orm^^f eed^mode ; 
pr int__^ext ent jmode ; 

printer_^to^host_mode; /* Level 3 */ 
printer^^assignment; /* sessions */ 
pr inter__port_environment ; 
printer^style; 


/* 

* Graphics 
*/ 

ext graphics^cursor_enable_mode__t 

graphics__cursor__enable__^mode; /* ReGIS */ 


/* 

* communications layer 

ext int host^ort; /* logical unit number for comm port */ 

ext int printer_port; 


/**★*★***★**★★★ module char__cell extern. h *★******★★*★*/ 

/* 

* external storage declarations for character cell display state 

* PAS 28-JU1-1989 
*/ 
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♦define MAX_NUM_LINES 73 
♦define MAX_NUM__COLUMNS 133 
♦define EMPTY_CHARACTER 0 
♦define MAX_NUM_CHAR_SETS 8 
/* character set table entries */ 

♦define TABLE__ASCII 0 
♦define TABLE_LINE_D RAWING 1 
♦define TABLE__DEC_SUPP 2 
♦define TABLE_NRCS 3 
♦define TABLE_LATIN1 4 
♦define TABLE_UPSS 5 
♦define TABLE_TCS 6 
♦define TABLE_DRCS 7 

/* Note DRCS must be last in search order 
to replace others if identical */ 


ext char act er^t 

ext line_rendition_t 

ext character_jDosition_t 

ext line__t 

ext line^t 

ext column^t 

ext column^t 

ext boolean^^t 

ext active_display__t 

ext status___display__t 

ext char__set_designator_^t 

ext save^buf fer__^t 

ext char act er^rendition^t 

ext character__attribute__t 

ext boolean^t 

ext column^mode^t 

line s_per__page_^t 
CO lumn s_pe r_^a ge^^t 
nuinber_^o f ^age s__t 
s c r o 1 1 in g_^mo de_t 
screen__mode__t 
originjmode___t 
au t o_wr ap__mode_J: 


display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] / 
line_rendition[MAX_NUM_LINES] ; 
act ive_jposition ; 
t op^mar gin ; 
bottom^^margin ; 

left_margin; /* Horiz scroll ext */ 

right^margin; /* Horiz scroll ext */ 

1 as t__co lumn_f lag ; 
act ive^di splay; /* 
status__di splay; /* 
char_set_table[MAXJNUM_CHAR__SETS] ; 
cursor__save_buf fer; 
current^rendition ; 

current_attribute; /* Selective Erase*/ 
hor i z on t a l_t ab__s t op s [ MAX__NUM_COLUMN S ] ; 


L3 or Status Dsply*/ 
L3 or Status Dsply*/ 


ext 
ext 
ext 
ext 
ext 
ext 
ext 
ext 
ext 

ext new line mode t 


/* 

/* 

/* 

/* 


column^mode ; 
lines_per__page ; 
columns_per__page ; 
number_of _pages ; 
scrolling_jmode; 
screen^mode ; 
origin__mode ; 
au t o__wr ap_mode ; 
text cursor enable_mode t text__cursor^enable__^mode; 
insert_replace_mode__t insert__replacement_^mode ; 


132 Column Ext 
Windowing */ 
Windowing */ 
Windowing */ 


*/ 


new line mode; 


ext 


ext 


ext 


/* 

/* 

/* 


Windowing 

Windowing 

Windowing 


curs or__coupl ing_mode__t 

hor i z on t a l^^cu r s or_c oup 1 in g , 
vertical^^cursor^coupling, 
page^cursor^coupling; 
left___right_margins_mode_t 

left_right_jnargins__mode; /* Horiz Scroll */ 
are a_^e xt en t__t 

att ribute_change__extent ; / ^ 


*/ 

*/ 

*/ 


/**★**★★**★ end of char cell extern, 


L4 or rect editing 
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3.3 STATUS AND TEST 

Upon request, a conforming device shall provide at the terminal interface a means of 
returning device status information. Status information consists of either "Device Ready" 
or "Device Malfunction". (See subhead 5, DEVICE STATUS REPORT.) The device status 
shall be set upon power-up initialization or receipt of RESET TO INITIAL STATE (RIS). 
See Video Systems Reference Manual - Documented Exceptions. 

The architecture does not define Uie nature or duration of specific device test sequences. 
The architecture provides a registry of test invocation control functions (Refer to DEC STD 
138-0 Registry of Control Functions for Character-Imaging Devices) that may have different 
effects on different products. However, failure of any applicable test sequences shall set 
the device status to the "Device Malfunction” state. 

3.3.1 Virtual Terminal Configuration 

If the Mtiltiple Sessions extension is supported, a conforming device shall provide a means 
at the terminal interface of returning information on whether the terminal is configured 
to support virtual terminals. Status information returned shall be in the form of a Device 
Status Report (DSR) (see subhead 6, Device Status Report) and consist of: "Virtual 
Terminals Not Enabled", "Virtual Terminals Enabled Over Physical Lines", "Wtual 
Terminals Available Through TD/SMP". 

This feature is intended for terminal management use. Specific information on the state of 
the Terminal Device/Session Management Protocol (TD/SMP) or other session management 
protocol shotild be ascertained through the protocol handler. 

3.3.2 Data integrity 

At Conformance Level 4, a conforming device shall provide a means at the terminal 
interface of returning the status of a data integrity fiag. Status information returned shall 
be in the form of a Device Status Report (DSR) (see subhead 5 Device Status Report) and 
consist of: "OK, no comm error detected since last report", "Error, a comm error has been 
detected since last report", or "Power-up, No request since last power-up or reset". 

This is an application feature for defensive programming, and not intended for terminal 
management or communications use. 

4 DEVICE INITIALIZATION 

On power up, all state information (state) in the terminal shall be set to a known value, or 
value previously selected by the user and stored through non-volatile means. This state is 
referred to as the Power-Up State. 

Since the architecture allows the Power-Up State of certain features to be set and stored 
under local control (Set-Up and non-volatile memory for example), software cannot rely 
on Uie values of this state after an appropriate initialization sequence is executed or a^r 
the device is powered up. The values given in the algorithm below apply only to those 
implementations in which the state cannot be set and stored locally by the terminal user. 
The state defined by the architecture to which this indeterminate condition may apply is 
limited to the following: 
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conformance level 


ho s t__po r t__e n V i r onme nt 
vt__conf iguration 
c l^t r an smi s s i on__mode 
transmit_rate_limit_jnode 
t er mina l__un d 

character's et__mode 
upss 

columns^er_page 
lines^er__page 
nimbe r_o f _page s 
status^di splay 


colimn^mode 

scrolling^mode 

screen__mode 

aut o__wr ap_mode 

t ext^cur s or__^enabl e^^mode 

n e w___l ine__^mo de 

hor i z ont a l__t ab_^S t op s 

ve r t i ca l_cu r s or _c oup 1 in g 
horizontal^cursor___coupling 
p age_^cu r s or_c oup 1 in g 


aut o___r epe at _jnode 
cur sor__key_mode 
caps^shift^lock_jnode 

keyboard^usage^mode 
backarrow__key_mode 
a 1 1 __k ey__mode 
compo se^k ey_jnode 
F l__^key__mode 
F2_^key__mode 
F 3_key__^mode 
F 4_key_jnode 


aut o_pr int^mo de 

print er_controller_mode 

p r i nt or m__f e e d_mode 


p r i n t _e xt en t__^mo de 
print er_t o__ho st^jnode 
printer_style 

graphics__cursor_enable__mode 

UDK definitions (see DEC-STD-070-11, UDK Extension) 


State Affected: 


All terminal state. See subhead 3.2, Terminal State Declarations. 

The following code example illustrates terminal management routines. 

Algorithm: 


/*★**★***:*:*★★★* Module terminal management. c ****:******:^**/ 
/* 

* terminal management routines 

* VT420 example 
*/ 


/* get access to global terminal state 
tinclude "terminal state extern. h" 
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/* function declarations */ 
void hardware^^init ( ) ; 
void coram^init () ; 
void setup^init ( ) ; 
void host_state__init ( ) ; 
void soft_terminal_^reset () ; 
int send__char ( ) ; 
int send__string ( ) ; 
int send_^int ( ) ; 
int send hex(); 


void power_jap__initialization () 


{ 

hardware__init ( ) ; 
conmi^init ( ) ; 
setup^init ( ) ; 
host_^state_^init () ; 

) /* end procedure 


/* actual hardware as needed */ 

/* communications layer */ 

/* features that are not host setable 
/* all host setable state */ 
power_up_^initialization */ 




void setup^init ( ) 

/* initialize local features that are not host setable */ 

{ 

host_jport^environment = EIGHT__BIT; NVM */ 

vt_configuration = SINGLE_SESSION; /* NVM */ 

control_^representation_^mode = 

INTERPRET_CONTROLS ; 

printer_port__environment = EIGHT^^BIT; /* NVM */ 
print er_style = NATIONAL_ONLY; /* NVM */ 

} /* end procedure setup^^init */ 


void host^^state^init ( ) 

{ 

line^t x; 
column^t y; 

/* 

/* do initialization */ 

/* Terminal Management */ 

conformance__level = LEVEL__4; /* NVM */ 

transmit_rate_limit_mode = LIMITED; /* NVM */ 
power_up_detected_f lag = TRUE; 
error___detected_flag = FALSE; 

vt__configuration = SINGLE_SESSION; /* NVM */ 

/* VT420 terminal unit ID exaunaple (different for each unit) */ 
terminal_unit_id = 0x01000001; /* HKO unit 1, NVM */ 

/* Code Extension */ 

upss = DEC_SUPPLEMENTAL_G; NVM */ 


in^use^table.cO * ASCII^^C; 
in_use_^table.gl = ASCII_G; 
in_^use_^table . invoked__gl = GO ; 

in_use_table.cl = SUPPLEMENTAL_C; 
in^^us eatable . gr = upss; 
in__use___table. invoked__gr = G2; 

des ignated^graphi onsets [0] = ASCII^G; 
designated__graphic__sets [1] = ASCII_^G; 
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switch (conforinance__level) 

{ 

case LEVEL__1 : 

in_use__table.gr = ASCII_G; 
designated_graphic_sets [2] = ASCII_G; 
designated_graphic_sets [3] = ASCII___G; 
cl_transmission_mode = SEVEN___BIT; 
character_set__mode = SEVEN_BIT__NATIONAL; 
break; 

case LEVEL_2 : 
case LEVEL_3 : 
case LEVEL_4 : 

designated__graphic_sets [2] = upss; 
designated_graphic_sets [3] = upss; 

cl_transmission__mode = EIGHT_BIT; /* NVM */ 

character___set_mode = EIGHT_BIT_MOLTINATIONAL; /* NVM */ 

}; 

parse__init (coinm_state) ; /* initialize ANSI parser */ 

single_shift * NO_SINGLE_SHIFT; 
in_control_string « NOT__IN_CONTROL_S THING; 

host__port_environment = EIGHT_BIT; /* NVM */ 

/* character cell display */ 
for (y*l; y<MAX_NUM_LINES; y++) 

{ 

for (x=l; x<MAX_NUM_COLUMNS; x++) 

{ 

display [y] [x] .code = EMPTY_CHARACTER; 

} 

line_rendition[y] == SINGLE_WIDTH; 

} 


column_mode * EIGHTY; 

/* 

NVM 

*/ 

scrolling_jnode = SLOW; 

/* 

NVM 

*/ 

screen_mode — NORMAL_S GREEN; 

f* 

NVM 

*/ 

origin_mode = ABSOLUTE; 




auto_wrap_mode = WRAP___OFF; 

/* 

NVM 

*/ 

text_cursor_enable_mode = TEXT CURSOR ON; 

/* 

NVM 

*/ 

insert_replacement_mode = REPLACE; 

/* 

NVM 

*/ 

new line mode = NEW LINE OFF; 

/* 

NVM 

*/ 

active_display = MAIN_DISPLAY; 




status_di splay = NO_STATUS_DISPLAY; 

/* 

NVM 

*/ 

horizontal__cursor_coupling = UNCOUPLED; 

/* 

NVM 

*/ 

vertical_cursor__Goupling = COUPLED; 

/* 

NVM 

*/ 

page_cursor_coupling == COUPLED; 

/* 

NVM 

*/ 

left_right___margins_mode = FIXED; 




attribute___change_extent = STREAM; 




lines_per__page =* 24; 

/* 

NVM 

*/ 


number_of_pages = MAX___NUM_LINES/lines_per_jpage; 

act ive_posit ion. line = 1; 
act ive_position .column = 1; 
active__page = 1; 
top_margin =1; 

bottom_margin = lines_per__page; 
left__margin * 1; 

/* if Windowing Extension, 

columns_per_jpage in NVM will override column___mode */ 
if (column_mode ~ EIGHTY) columns_per__page = 80; /* NVM */ 

else Goluinns_per__page = 132; 
right_jnargin = columns_j>er_page; 
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current:__rendit ion .bold = FALSE; 

current^^rendit ion .blink = FALSE; 

current^rendit ion .underscore = FALSE; 

current__rendition .reverse = FALSE; 

current^attribute . selective__erase = FALSE; 

horizontal_tab_stops[13 = FALSE; /* NVM / 

for (x=2; x<MAX_NUM_COLUMNS; x++) 

{ 

if (x%8 =s= 1) horizoAtal__tab_stops [x] = TRUE; 
else horizontal_tab___stops [x] = FALSE; 

} 

save__cursor 0 ; /* initialize cursor save buffer */ 
macro__init ( ) ; /* initialize text macros (Level 4) */ 

/* keyboard processing */ 
keyboard__action_mode = UNLOCKED; 
auto_repeat__mode = REPEAT^ON; 
cursor^^key^mode = CURSOR; 
keypad^mode = NUMERIC; 
keyboard_usage_mode = TYPEWRITER; 
caps_^shift_lock_mode = CAPS_LOCK; 
hold^screen^mode = HOLD^OFF; 
lock mode = LOCK_OFF; 
keycIick_mode = KEYCLICK^ON; 
send_receive__mode » ECHO^^OFF; 
backarrow__key_mode « DELETE; 
compos e_key_jnode = LOCAL; 
alt_^key_mode = REPORT; 

Flukey * LOCAL; 

F2_key = LOCAL; 

F3_key * LOCAL; 

F4_key = LOCAL; 

F5_^key_mode = L0CAL_F5; 
keyboard__encoding_jnode =* CHARACTER; 

/* printer port */ 
print erjport_environment = EIGHTHS IT; /* NVM */ 

printer__controller_jnode =* 

PRINTER_CONTROLLER_OFF; /* NVM */ 

auto_print_mode = AUTO_PRINT_OFF; /* NVM */ 

print_form_feed_mode = PRINT_FF_OFF; /* NVM */ 

printer_to_host_mode = NO_PRINTER_TO_HOST; /* NVM */ 
print_extent_mode = PRINTED I SPLAY; /* NVM */ 

printer_^assignment = SHARED; 

/* initialize other extensions */ 

graphics_cursor_enable_jnode * GRAPHICS_CURSOR_ON; /* NVM */ 
udk_init<); NVM '^ / 

drcs__init ( ) ; 

/* terminal management */ 
device^status = READY; 

}; end procedure host__state__init */ 


/* NVM */ 
/■k NVM */ 

/* NVM */ 
/* NVM */ 


/* NVM */ 
/* NVM */ 
/* NVM */ 
/* NVM */ 
/★ NVM */ 
/* NVM */ 
/* NVM */ 
/k NVM */ 
/★ NVM */ 
/* NVM 



16 


Digital Internai Use Only 


EL-00070-04 


04-0ct-1990 


5 CONTROL FUNCTIONS 

DEVICE ATTRIBUTES (Primary) DA 


Levels: lx, 2, 3, 4 

Purpose: Request or report the device attributes. 

Request Format: 

CSI Ps c default Pss 0 

9/11 Ps 6/3 

Response Format: 


CSI ? Ps c 

9/11 3/15 Ps 6/3 

Description: Use the primary Device Attributes (DA) control to request or report the 
implemented architectural conformance level and extensions. An omitted parameter or 
a parameter value of zero (0) indicates a request for identification. The response to the 
primary DA request consists of request for a DA control sequence using a private parameter 
string with the introducer 3/15 (?) followed by a variable number of pareuneters. 

The first parameter in the string indicates the basic service class of the device and the 
architectural level to which the device conforms. The rest of the parameters indicate the 
architectural extensions supported at the current operating level. 

NOTE 

Exceptions to the architecture that are documented as appendices to these 
standards are not reported in the primary DA response. 

The value of the first parameter is encoded so that a simple range check can be performed 
to determine the basic service class and level of the device. Each service class is designated 
a range of decimal values from 1 to 9. For example, Character Cell Display devices are in 
the range 61 to 69. The architectural level to which the device conforms is indicated by the 
low order digit. Thus, a response with a first parameter of 61 indicates that the device 
conforms to Level 1 of the Character Cell Display architecture. Hi^er levels, by definition, 
support the fiinctionality of lower levels of the same service class. 

Therefore, if a device code of 63 is returned, the device may be supported as a Level 1, 
Level 2, or Level 3 Character Cell Display device. This does not mean higher conformance 
levels are strict supersets of lower conformance levels, but that a device that supports a 
higher conformance level must support the lower levels as well (using DECSCL). 

In general, higher conformance levels are supersets of lower levels, but specific 
control functions can be interpreted differently to accommodate evolving requirements. 
Conforming software shall select a known conformance level to guarantee compatibiUty. 
See the description of Select Conformance Level (DECSCL) in this document for further 
information. 
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Note that the device code in the response represents the highest level that the device 
can support, and does not indicate the level at which the device is currently operating. 
For example, a Level 3 conforming device operating at Level 2, as selected by the Select 
Conformance Level control function, would still respond with a device code of 63. 

Table 1 lists extensions to the character cell display service class registered within Digital 
that may be transmitted by a device in response to an appropriate request. Levels 1-4 
(DA parameters 61 - 64) have been defined for the character cell display service class. 
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Table 1 : 

Registered Extensions to the Character Cell Display Service Class 

Extension 

Parameter 

Levels 

Extension Name 

1 

1 -4 

1 32 Column Display 

2 

1 -4 

Printer Port 

3 

1 -4 

ReGIS Display 

4 

1 -4 

Sixels Display 

5 

1 -3 

Katakana 

6 

2-4 

Selectively Erasable Characters 

7 

2-4 

Dynamically Redefinable Character Sets 

8 

2-4 

User Defined Keys 

9 

1 -4 

National Replacement Character Sets 

10 

1 -3 

Kanji 

11 

2 

Status Display 

12 

1 -3 

Serbo-Croatlon 

13 

1 -3 

Block Mode 

14 

2 

8-bit Interface Architecture 

15 

2-4 

Technical Character Set 

16 

1 -4 

Locator Port 

17 

2 

Terminal State interrogation 

18 

2-4 

Windowing 

19 

2-4 

Multiple Sessions (TD/SMP) 

20 

1 -4 

APL 

21 

2-4 

Horizontal Scrolling 

22 

2-4 

Color Text 

23 

1 -3 

Greek 

24 

1 -3 

Turkish 

25 

2.3 

Arabic Bilingual Mode 1 

26 

2,3 

Arabic Bilingual Mode 2 

27 

2,3 

Arabic Bilingual Mode 3 

28 

2,3 

Rectangular Editing 

29 

2-4 

Text Locator 

30 

2,3 

HanzI 

31 



32 

2-4 

Text Macros 

33 

2,3 

Hangul and Hanja 

34 

2,3 

Icelandic 

35 

2,3 

Arabic Bilingual with Text Controls 

36 

2.3 

Arabic Bilingual with no Text Controls 

37 

2.3 

Thai 

38 

2,3 

Character Outlining 



Digital internal Use Only 


19 







EL-00070-04 


04-0ct-1990 


Implicit Extensions 

Implicit Extensions are features originally defined at a higher conformance level that still 
operate when a lower conformance level is selected and are not required to be exphcitly 
reported. The "8-bit Interface Architecture" extension, for example, was originally defined 
in Level 3 and as an extension to Level 2. A Level 3 device operatii^ at Level 2 need not 
disable the 8-bit Interface Architecture Extension, nor report it explicitly as a parameter 
in the DA response. Level 3 or higher defines 8-bit Interface Architecture to be an implicit 
extension to Level 2. 

Each conformance level may define a set of implicit extensions at lower levels. Hi^er 
conformance levels must support all the imphcit extensions defined by lower levels. 
Imphcit extensions must only be allowed if they are fully backward compatible with the 
lower conformance level. 

Software can determine whether an implicit extension is present by seeing if the reported 
conformance level is greater than or equal to the conformance level at which the feature 
was originally defined. 

If a hi^er conformance level subsumes extensions previously reported at a lower level, 
these extensions shall be reported at the lower level so that existing software can determine 
if the extension is present. 

Defining implicit extensions allows features defined by a higher conformance level to 
operate at a lower conformance level if they are consistent with that level. 



Operating Level 

Implicit Extension 


2 or higher 

1 

DECSCL 


3 or higher 

2 

11 Status Dispiay 



2 

14 8-bit Interface Architecture 



2 

1 7 Terminal State Interrogation 


4 or higher 

1»3 

DECSR 



State Affected: None 
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Algorithm: 

void device^attributes^l 0 
{ 

int n; 

send__char (0x9B, host^ort) ; 
send__string ("?64" , host_port) ; 
if (conf ormance^level == LEVEL__1) 

for (n=l; n<NUMBER_OF_EXTENS IONS ; n++) 
if (level__l_^extonsions [n] ~ TRUE) 

{ 

send^char ( ' ; ' , host jport ) ; 
send^int (n, host_j>ort) ; 

}/ 

if (conf ormance__level == LEVEL_2) 

for (n=l; n<NUMBER_OF_EXTENS IONS ; n++) 
if (level__2__extensions [n] ~ TRUE) 

{ 

send__^char ( ' ; ' , host__port ) ; 
send__int (n, host^port) ; 

}/ 

if (conformance^level = LEVEL__^3) 

for (n=l; n<NUMBER_OF_EXTENS IONS ; n++) 
if (level_^3_extensions [n] “ TRUE) 

{ 

send^^char ( ' ; ' ^ host^port ) ; 
send^int (n, host^port) ; 

}; 

if (conformance__level == LEVEL_4) 

for (n=l; n<NUMBER_OF_EXTENSIONS/ n++) 
if (level_4_extensions [n] == TRUE) 

{ 

send^^char ( ' ; ' ^ host_jport ) ; 
send__^int (n, host_jport) / 

}; 

send__char (' c' , host^port) ; 

}; 


Known Deviations: 

Terminals designed before this architecture was developed do not conform to the above 
encoding scheme. They will, however, respond to the Device Attributes request by 
returning a DA control with a variable length parjimeter string. The first parameter of 
this parameter string is a device-specific code in the range 1 to 59. Thus, these devices 
are easily distinguished from those that implement the architectural response, whose first 
parameter is always 60 or greater. 

Some termineils provide an alias ID (identification) capabihty, selectable under local control, 
to emulate the DA response of older terminals. The factory default will always be to 
respond with the correct identification code for the family of devices in which the interface 
is implemented. 

The Greek and Turkish special versions of the VT200 and VT300 series use extension 
parameters 10 and 11 instead of the registered parameter values 23 and 24, respectively. 
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SELECT CONFORMANCE LEVEL 


DECSCL 


Purpose: Select a particular level of operation for interface compatibility. 

Levels: lx, 2, 3, 4 
Format: 

CSI Ps ; Ps " p 

9/11 Ps ; Ps 2/2 7/0 

Description: The Select Conformance Level (DECSCL) control selects a terminal 
operating mode that provides interface compatibiHty defined by a conformance level of the 
architecture. The operations and state information available in each level are fully defined 
in the architectural specifications. The first parameter selects the conformance level of 
operation. The optional second parameter appUes only to Level 2 (it will be ignored in Level 
1 operation). The second parameter may be used to select the Cl control transmission for 
7-bit or 8-bit controls, in accordance with the following table: 


0 - default (8 -bit Cl controls) 

1 - 7-bit Cl controls 

2 - 8-bit Cl controls 

NOTES 


1. The DECSCL control function is required only in Level 2. However, in Level 2 
(and higher) conforming devices, the DECSCL control must also be executed 
when the device is in Level 1 operation. This is an exception to the normal 
rule that Level 2 functions only work in Level 2 operation, and is necessary to 
enable switching between levels. DECSCL is an Implicit Extension to Level 1. 

2. At the present time, four conformance levels are defined by the Terxninal 
Interface Architecture (TIA): 

61 - Level 1 Character Cell Display Terminals 

62 - Level 2 Character Cell Display Terminals 

63 - Level 3 Character Cell Display Terminals 

64 - Level 4 Character Cell Display Terminals 

Software should be designed to anticipate future higher-numbered levels that 
will be supersets of Level 1-4. 

3. Selecting a particular conformance level also causes a "soft reset" of the 
terminal to be performed. This automatically places the terminal into a known 
state, without affecting the data contained in the display. See Soft Terminal 
Reset, DECSTR, for more information. 

4. Attempts to select conformance levels that are unsupported by the device will 
be ignored. 

State Affected: 

conformance_level 

cl_transmission_mode 

Algorithm: 



22 


Digital internal Use Only 



EL-00070-04 


04-0ct-1990 


void select__conformance_level (service^olassy cl__mode) 
int service^class; 
int cl__mode; 

{ 

switch (serviGe__class) 

{ 

case 61: 

conformance__level = LEVEL^l; 
break; 
case 62 : 

conformance^^level = LEVEL__2; 
break; 
case 63 : 

conformance^^level = LEVEL_3; 
break; 
case 64 : 

conformance^^level = LEVEL__4; 
break; 

default: return; 

}; 

soft_^terininal_reset () ; 
switch (cl_jnode) 

{ 

case 0 : 
case 2 : 

cl__transmission_jnode = EIGHT_BIT; 
break; 
case 1 : 

cl_transmission_mode = SEVEN_BIT; 

}; 

}; /* end procedure select^conf ormance_^level ( ) */ 

Known Deviations: None 
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DEVICE ATTRIBUTES (Secondary) DA2 

Levels: IX, 2, 3, 4 

Purpose: Request or report the device identification. 

Request Format; 

CSI > Ps c Default Pa: 0 

9/11 3/14 Ps 6/3 

Response Format: 

CSI > Ps c 

9/11 3/14 Ps 6/3 

Description: The DA2 control requests or reports the identification code of the specific 
product in which the interface is implemented. The request consists of a DA control 
sequence with the private parameter code 3/14 (>) and an omitted parameter or a 
parameter value of zero (0). 

The response to the DA2 request consists of a DA control sequence with the private 
parameter code 3/14 (>) followed by a variable number of parameters. The first parameter 
indicates the product specific identification of the device. This parameter value shall be 
registered with the architecture. 

The second parameter indicates the revision level of the firmware or software implementing 
tlie terminal management functions. Revision levels are generally noted by a real number 
with one significant decimal. This number should be (not mandatory) multiplied by 10 and 
used as the value of the second parameter. 

Additional parameters may be present to indicate options installed in the device. These 
options are implementation defined, and the number and meaning of the additional 
parameter values vdll be product dependent, however, these values shall be registered with 
the architecture. 

State Affected: None 
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Algorithm: 


void device_^attributes_2 0 

{ 

int n; 

send__char (0x9B, host^port) ; /* CSI */ 

send^int (PRODUCT_^ID, host_jport) ; 
send^^char , host^port) ; 
send_int{REVISION_LEVEL, host_port) ; 

/* Device IDs and options must be registered */ 

/* VT420 has no options — 

for (n*l; n<NUMBER_OF_OPTIONS; n++) 

{ 

if (product^^options [n] === TRUE) 

{ 

send__ahar ( ' ; ' , host^port ) ; 
send__int (n^ host__port) ; 

} 

}; 

"*/ 

send__char (' c' , host^ort) ; 

}; /* end procedure device_^attributes_2 () */ 

Known Deviations: 

Terminals designed before the Terminal Interface Architecture (TIA) was developed do not 
implement this control. Terminals that return a first parameter value less than 60 to the 
primary Device Attributes (DA) will ignore the secondary Device Attributes (DA2) control. 
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DEVICE ATTRIBUTES (Tertiary) DA3 

REPORT TERMINAL UNIT ID DECRPTUI 


Level: 4 

Purpose: Request terminal unit identification. 

Request Format: 

CSI = c 

9/11 3/13 6/3 

Description: The Tertiary Device Attributes Request (DA3) causes the terminal to report 
its unique terminal unit ID to the host using the DECRPTUI (Report Terminal Unit ID) 
sequence. The terminal unit ID consists of a string of up to 31 displayable characters that 
are factory set to a unique value for the specific product (DA2 registration) in which the 
interface is implemented. 

Individual products may further restrict the length or format of the terminal unit ID as 
long as the identifier continues to provide a unique ID within that specific product. The 
format of the Terminal Unit ID shall be registered with the architecture. 

Report Terminal Unit ID 

Format: 

DCS ! I D. . .D ST 

9/0 2/1 7/12 ?/? 9/12 

Implementation Guideline 

The VT420 terminal unit ID consists of a 32-bit number reported as four hex pairs. The 
first hex pair (8 bits) contains the manufacturing site code, and the remaining three hex 
pairs (24 bits) contain a serial number for that site. The site code and serial number 
together provide a unique ID for each VT420. See DEC STD 138-0 for a listing of 
manufacturing site codes. 

The terminal unit ID is factory set and does not change unless the terminal’s internal 
circuitry is repaired or replaced. In the VT420, the unit ID is maintained in Non-Volatile 
Memory (NVM) and can be rewritten in the event of NVM failure using the DECSTUI (Set 
Terminal Unit ID) sequence. This sequence is only recognized when the NVM checksum is 
invalid, or when an internal jumper on the main board is set. 


Set Terminal Unit ID (DECSTUI) Format: 

DCS ! { D. . .D ST 

9/0 2/1 7/11 ?/? 9/12 

State Affected: None 
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Algorithm: 


void device_^attributes_^3 0 /* VT420 example */ 

{ 

int n; 

send__char (0x90, host_j>ort) ; /* DCS */ 

send_^string (” ! | hostjport) ; 

n = (terminal_unit_id » 24) & OxFF; 

send__hex(n, host__port) ; 

n = (terminal_unit_id » 16) & OxFF; 

send_hex(n, host^ort) / 

n = (terminal__unit__id » 8) & OxFF; 

send_^hex(n, host^ort) ; 

n = terminal__unit___id & OxFF; 

send__^hex (n, host__port.) ; 

send^^char (0x9C, host___port) ; /* ST */ 

} /* end procedure device__attributes_3 () */ 

Known Deviations: None 
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IDENTIFY TERMINAL DECID 

Levels: 1, 2 

Puxpose: Request the device identification code. 

Format: 

ESC Z 

1/11 5/10 

Description: The DECID control requests that the terminal report the implemented 
architectural conformance level and extensions. The device responds by transmitting an 
appropriate primaiy Device Attributes (DA) response. 


NOTES 


a. This control is identical to a primary DA ccmtrol with an omitted parameter or 
a parameter value of zero (0). THIS CONTROL IS RESERVED FOR FUTURE 
STANDARDIZATION BY ISO AND ANSI. Conforming software shafi use the 
primary Device Attributes (DA) control for purposes of device identification. 

b. DECID is not recognized at Level 3 or above. 

c. Terminals that implement the VT52 emulation hardware option respond 
differently to this control when in VT52 mode. See Video Syatems Reference 
Manual - VT52 Emulation for more information. 

State Affected: None 
Algorithm: 


/* 

* DECID ESC Z 

* Ignored above Level 2 

* execution is same as primary DA 
*/ 

void id() 

{ 

if ( (conf ormance^level ** LEVEL^l) 1 | 
( (conformance^level ** LEVEL_2) ) 
device_attributes_l ( ) / 

}; 


Known Deviations: 

The VT300 family and VT420 do not have a fully independent VT200 mode, and ignore 
DECID when set to conformance Level 2. 

See additional deviations under Device Attributes (Primary). 
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SECURE RESET DECSR 

SECURE RESET CONFIRMATION DECSRC 


Levels: 4 

Purpose: To ensure that the terminal is in a known state so that data sent to the terminal 
is displayed as expected, and keystrokes from the terminal transmit as expected, and to 
erase any host-writeable data in the terminal. 

Format: 

CSI Pn + P 

9/11 3 /? 2/11 7/0 

Description: Secure Reset initializes the terminal to its Power-Up state and erases all 
host setable state information and data. If a non-zero numeric parameter in the range 1 
to 16383 is provided, the device responds with a Secure Reset Confirmation (DECSRC) 
control function with the same parameter upon successful completion. If Pn is omitted or 
zero, no response is generated. If Pn exceeds 16383, the entire sequence shall be ignored. 

Secure Reset Confirmation 

Format: 

CSI Pn * q 

9/11 3/7 2/10 7/1 

NOTES 


1. DECSR is recognized at all conformance levels (Level 1 or higher). 

2. DECSR is recognized in Control Representation Mode (Display Controls Mode, 
CRM set) and causes the device to exit this mode. This is desirable because 
CRM is enabled under local control in video terminals and there is no other 
way to clear it from the host. If the terminal is in Display Controls Mode, 
DECSR shall be displayed before it is executed. 

3. DECSR is not recognized in VT52 Mode (DECANM reset), or Tektronix 
4010/4014 Emulation Mode (DECTEK). Host software must explicitly exit these 
modes. This is necessary because these modes do not use ANSI compatible 
S3mtaxes. 

4. DECSR is not recognized (intercepted) in Printer Controller Mode (see Media 
Copy - MC). Host software must explicitly exit this mode. Secure Reset may be 
sent to an attached printer in Printer Controller Mode. 

5. DECSR is buffered in the same way as other incoming data. 

6. In a multiple-session device, DECSR only affects the session that receives the 
control function. At the time of this update to the standard, secure connections 
are only supported in single-session devices. Reconfiguring the device from a 
single-session to multiple-sessions causes a BREAK to be generated to alert 
host software. 
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7. Secure Reset need not erase data maintained in Non-Volatile Memory (NVM) 
as long as such data cannot be written from the host. If values for some state 
information can be stored under host control in NVM, then DECSR should 
erase this NVM (not mandatory). 

8. DECSTUI, which sets the terminal unit ID, is an exception to the previous 
note since it is only recognized if the NVM checksum is invalid, or an internal 
jumper has been installed. In normal operation, the terminal unit ID cannot 
be written from the host. 

State Affected: 

Secure Reset affects all host setable state similar to power-up initialization. See subhead 

4, DEVICE INITIALIZATION. 

The following state information is also explicitly reset; 

UDKs 

The UDKs are erased to be empty, or restored to the value saved in NVM if such NVM 
is present and not writable from the host. The UDK definitions are re-initialized even 
if the "UDKs Locked" state is in effect. 

DECS 

Macro Definitions 

clears the keyboard input silo 

erases all local buffers that might contain data from host (such as paste_buffer, 
capture_buffer, etc...) 

Secure Reset does not affect host port receive buffers, nor session management state (if 

present). 

Algorithm: 


void secure^reset (param) 
int param; 

{ 

if (param <= 16383) /* 0x3FFF */ 

{ 

/* exit CRM */ 

control__representation_jnode = INTERPRET^CONTROLS ; 

/* initialize all host setable state 
host__state_init ( ) ; 
clear^udk ( ) ; 

/* report reset was successful if non-zero parameter */ 
if (param != 0) 

{ 

send_^char (0x9B, host^ort) ; 
send___int (param, host_port) ; 
send^string ( ” *q” , host_j>ort ) ; 

}; 

}; 

}; /* end procedure secure^reset () */ 

Known Deviations: None 
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SOFT TERMINAL RESET 


DECSTR 


Levels: 2, 3, 4 

Purpose: Reset soft terminal state to the default values. 

Format: 

CSI ! P 

9/11 2/1 7/0 

Description: The DECSTR control sets the modes available to user application programs 
to known values. User Preference Features are not affected. DECSTR is intended for 
application use, whereas User Preference Feature control ftinctions are intended for 
terminal management use. When the DECSTR control is received, the following state 
information in the terminal shall be reset as indicated below. This list defines the Soft 
Terminal Reset state. 


State 

Default 

Top Margin 

1 

Bottom Margin 

number of lines on page 

Left Margin 

1 

Right Margin 

80 (or 132 if column mode is set) 

Current Rendition 

normal 

Current Attributes 

not selective erasable 

In Use Table (gl, gr) 

set to current level defaults 

Designated Sets 

set to current level defaults 

Cursor Save Buffer 

set to current level defaults 

Insert/Replacement Mode 

reset (Replace) 

Origin Mode 

reset (Absolute) 

Auto Wrap Mode 

Auto Wrap Off (NVM If present) 

Character Set Mode 

8-bit Multinational (Ignore NVM) 

Cursor On/Off 

on (Ignore NVM) 

Active Display 

Main Display (status display is exited) 

UPSS 

DEC Supplemental (NVM If present) 

Cursor Key Mode 

reset (Cursor) 

Keyboard Action Mode 

reset (Unlocked) 

Keypad Mode 

reset (Numeric) 

Keyboard Encoding Mode 

character 


The following User Preference Features are NOT siffected by the soft reset. 

Column Mode 
Scroll Mode 
Screen Mode 
Auto Repeat Mode 
Caps/Shift Lock Mode 
Tab stops 
Key click 
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The following are also NOT affected by the soft reset. 

The data in the display 
New Line Mode 
Line Attributes 
Printer Controller Mode 
Auto Print Mode 
Compose Mode 
Cl Transmission Mode 
Conformance Level 
DRCS 
UDK 

Macro Definitions 


NOTES 


a. Numeric is the default state for Keypad Mode. It is the i>ower-up default state 
for the terminaL It is preferred that operating systems perform translation 
of keypad codes for applications software at the time data is passed to 

the application. This allows applications to clear the type-ahead buffer to 
ensure ssmchronization when changing ke 3 rpad mode. Operating systems 
implementing this strategy should set Keypad Mode to Application after 
performing the soft reset and do the required translation. 

b. The DECSTR control is ignored when operating at Level 1 and by Level 1 
devices. 

c. DECSTR has no affect on the Active Position. 

d. When the terminal is in Printer Controller Mode, the DECSTR control is not 
executed by the terminal, but is transmitted instead to the printer port. Thus, 
DECSTR does not reset the terminal state unless Printer Controller Mode is 
explicitly reset before DECSTR is transmitted. 

e. DECSTR is interpreted differently in printing devices to achieve the 
corresponding concept of resetting the device to known application state 
while preserving the data currently on the display (previously printed, or 
buffered in the printer). 
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State Affected: 

See subhead 4, DEVICE INITIALIZATION for type declarations. 

/* VT420 example */ 

/* code extension layer state */ 

graphic__character__set_t designated^graphi assets [4] / 
in_use__^t ablest in__use_^table; 

character's et_mode__t char act er__set_mode; /* NRCS */ 

graphic_^character__set__t upss /* L3 or 8 -bit lA */ 

/* character cell display state */ 

1 ine^t t op^mar gin ; 

line^^t bottomjmargin; 

column_t leftjmargin; /* Horizontal Scroll */ 

column__t right_jnargin/ /* Horizontal Scroll */ 

left___right_^margins__mode__t left_right_margins__mode; /* H Scroll */ 
active__display__t act ive^di splay; /* L3 or status display */ 

s ave^buf f er_t cur s or_s ave^bu f f er ; 

character_rendition__t cur renter endition; 

character_attribute__t current^^attribute; /* Selective Erase */ 
origin^mode^t origin^mode; 

auto_wrap__mode_t auto__wrap_mode ; 

text__cursor__enable_^mode^t text__cursor_^enable__mode ; 
insert_replace_^mode_t insert_replacement__mode ; 
new_^line__mode__t new_line_jnode; 

/* keyboard processing state */ 
keyboard_actionjmode__t keyboard__action_jnode ; 
cur sor_^key_mode_^t cur sor__key_mode ; 

keypad^mode^t keypad__mode/ 

keyboard_^encoding_jnode_t keyboard_encoding_jtiode; /* L4 */ 


digital 
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Algorithm: 

void soft__terininal__reset () 

{ 

if (conformance^^level != LEVEL__1) 

{ 

/* Code Extension */ 

upss = DEC_SUPPLEMENTAL_G; /* NVM */ 

in__use__table ocO = ASCII^C; 

in_use__J:able «gl = ASCII__G; 

in_use_taJDle o invoked__gl = GO; 

in_usej:able.cl = SUPPLEMENTAL^C; 

in_jjse_table -gr =* upss; 

in_^use__tad?le«invoked__gr = G2; 

designated__graphic__sets [0] = ASCII^^G; 

designated_graphic_sets [ 1] = ASCII__G; 

designated^graphic^sets [2] = upss; 

designated^graphic^sets [3] =* upss; 

character_set_mode * EIGHTHS ITjyiULTINATIONAL; /* NVM */ 

/* character cell display */ 
origin_mode * ABSOLUTE; 

auto_wrap_mode = WRAP_OFF; /* NVM '^ / 

text_cursor_enable_mode = TEXT_CURSOR_ON; /* NVM */ 

inserter eplacement^mode * REPLACE; /* NVM */ 

new_line_mode * NEW_LINE_OFF; /* NVM */ 

active_display = MAIN__DISPLAY; 
left_right__margins_jnode = FIXED; 
top^margin = 1 ; 

bottom^margin = lines^er^page; /* NVM */ 

left_jnargin = 1; 

right^margin = columns^er^page; /* NVM */ 

current^rendition.bold - FALSE; 

current__rendit ion. blink = FALSE; 

current__^rendit ion. underscore = FALSE; 

current_^rendit ion. reverse = FALSE; 

current^^attribute . select ive^erase = FALSE; 
save^^cursor ( ) ; /* initialize cursor save buffer */ 

cursor_^save_^buffer. posit ion. line = 1; 
cur sor_save__buffer .position. column * 1; 
cursor_save__^buffer .posit ion. page = 1; 

/* keyboard processing */ 
keyboard__action__mode = UNLOCKED; 

cursor__key__mode = CURSOR; /* NVM */ 

keypad__mode = NUMERIC; 
keyboard^encoding__^mode = CHARACTER; 

}; 

}; /* end procedure soft_terminal_reset () */ 

Known Deviations: 

VT2008, VT300s, and the VT420 clear auto wrap (ignore NVM). DECterm VI does not 
change the current setting of auto wrap. This was necessary for ULTRIX systems that 
depend on auto wrap being enabled when a new terminal is initialized. 
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DEVICE STATUS REPORT 


DSR 


Levels: 1, 2, 3, 4 

Purpose: To cause the terminal to report the current functional status. 
Request Format: 


CSI 

Ps 

n 

9/11 

Ps 

6/14 

Report Format: 

CSI 

Ps 

n 

9/11 

Ps 

6/14 


Description: The DSR request, with selective parameter, causes the terminal to respond 
with a corresponding DSR control using a parameter from the table to indicate its current 
functional status. 

Levels 1-4 

5 request terminal status (command from host) 

0 device ready 

3 device not functional 

Level 4 

?75 report status of data integrity flag (command from host) 

?70 ok, no comm errors or power-up since last report 

?71 error, a comm error has been detected since last report 

?73 power-up, data integrity flag has not been reported since last power-up or RIS 

Multiple Sessions Extension 

?85 report virtual terminal configuration (command from host) 

?81 virtual terminals available through TD/SMP 

?83 not configured for virtual terminals 

?87 virtual terminals operating via physical lines 


NOTES 


1. Some Device Status Reports (DSRs) are part of terminal management, while 
others pertain to presentation state or input processing. See DEC STD 070-5 
Video Systems Reference Manual - Character Cell Display and DEC STD 070-7 
Video Systems Reference Manual - Printer Port Extension for additional DSRs. 
The report status of the data integrity flag DSR is intended for application use. 

2. On hardcopy devices DSR has often been processed asynchronously ahead of 
other data in the input bufrer (guideline). 
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3. TD/SMP is described in the "Terminal Device/Session Management Protocol" 
Version 1 Architecture Specification, 13-Feb-1986. 

State Affected: 

error_detected_f lag /* if DSR with Ps == ?75 is requested */ 

po we r_up_de t ec t e d^f 1 ag 

Algorithm: 

void report_device_status (request, private) 
int request; 
boolean^t private; 

{ 

switch (request) 

{ 

case 5 : 

if (device_^status == READY) 

{ 

send_^char (0x9B, host^ort) ; 
send^string ( "On" , host_jport) ; 

> 

else 

{ 

send^char (0x9B, host_j>ort); 
send^string ( "3n" , host^port ) ; 

} 

break; 
case 75s 
if (private) 

{ 

if ( ! error__detected_f lag && !power__^up__detected__f lag) 

{ 

send__char (0x9B, host^ort) ; 
send^^string ( "?70n" , host__port); 

} 

else if (power_up_detected_^flag) 

{ 

send_^char (0x9B, host__port) ; 
send^string ( "?73n" , host_j>ort); 
power_^up_^detected_f lag = FALSE; 

} 

else 

{ 

send_^char (0x9B, host__port) ; 
send__string("?71n", host^port); 
error_detected__f lag = FALSE; 

}; 

}; 

break; 
case 85: 
if (private) 

{ 

send__char (0x9B, host^port) ; 
if (vt^conf iguration =* SINGLE__SESSION) 
send_string ( "?83n" , host_port) ; 
else 

if (vt^^configuration == SESSIONS_ON___COMM) 
send^string ( "?81n" , host^port) ; 
else 

send_string ( "?87n" , host__port) ; 

}; 

break; 

} 

}; /* end procedure report_device_status () */ 
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Known Deviations: 

The VTSSO and VT340 terminals do not implement the Virtual Terminal Configuration 
Device Status Reports. 

The VT420 can report "?80 virtual terminals operating through TD/SMP", and include a 
second parameter that indicates the number of sessions available (when the first parameter 
is ?80 or ?81). It was later agreed that protocol state information should be obtained 
through the protocol handler, so this has not been standardized. 
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6 CHANGE HISTORY 

6.1 REVISION 0.0 TO 0.1 

The following changes were made to accommodate integration of this specification with the 

Video Systems Reference Manual: 

1. The name of this section was changed firom "Terminal Management Level 1" to 
"Terminal Management". 

2. All references to Level 1 operation only were removed, and explicit references to Level 
1 and Level 2 operation were added for all functions. 

3. Some of the state names were changed to be consistent with the rest of the Video SRM. 

4. The sections on Warning Bell and Text Cursor Enable Mode were removed to the 
section "Character Cell Display". 

5. All sections on printer functions were removed to the section "Printer Port Extension". 

6. The section on Hard Copy (DECHCP) was removed to the section "Sixel Graphics 
Extension". 

7. Sections firom the "Character Cell Display" section on Reset to Initial State and Device 
Status Report were added to this section. 

8. New sections on Soft Terminal Reset and Answerback were also added to this section. 

9. The algorithm for Reset to Initial State was corrected. 

10. The coding of the DECID sequence was corrected. 

11. Coding of other controls (most of which were removed to other section) were also 
corrected. 

12. The coding of the Device Not Ready status response to Device Status Report was 
corrected. 

6.2 REVISION 0.1 TO AX10 

1. Removed statement that the revision level code in the secondary Device Attributes 
response would be zero for unreleased products. 

2. Removed Answerback to an appendix. Answerback messages will not be required for 
conforming hardware. 

3. Added Selectively Erasable Character extension to the primary Device Attributes 
response with parameter 6. 

4. Made code changes in the primary DA algorithm. Fixed a bug in the Select 
Conformance Level algorithm. 

5. Added note that DRCS and UDK state is cleared on Reset to Initial State in Level 2 
terminals. 

6. Made changes in the tables of affected state in the Soft Terminal Reset function. 

7. Removed DECTST (Test) from the SRM. It will not be a required function for 
conforming hardware. However, Device Status Report will be required. 

8. Removed Control Representation Mode from RIS. 
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9. Clarified that the device code returned by Primary Device Attributes will not change 
when the operating level changes. 

10. Made New Line Mode unaffected by Soft Terminal Reset. 

11. Added a note to Select Conformance Level to indicate that it is a required function in 
Level 2 only, but is active in Level 1 operation of Level 2 devices. Removed deviation 
notes on VTIOO family for this function. 

12. Removed Reset To Initial State as a required fiinction, and placed it in Appendix D 
Documented Exceptions. It is not intended for use by conforming software. The RIS 
algorithm is now included in this section under the heading "Device Initialization". 

13. Made Primary Device Attributes, Select Conformance Level, and Secondary Device 
Attributes a "temporal" extension to Level 1 (required in all future Level 1 
implementations). 

14. Added initiahzation of the character set table of designating escape sequences to the 
Soft Terminal Reset control. 

15. Added setting of the Cursor Save Buffer values to the level defaults in Soft Terminal 
Reset. 

6.3 RevAXIOtO AX11 

Added "9 - NRC" to the list of Level 2 extensions. 

6.4 Rev AX11 to AX12 
GENERAL: 

1. Removed Rev AXll change bars. Added change bars to any change that could affect 
conformance or interpretation of the document or should be brought to the attention of 
terminal implementors or software engineers. 

2. Updated Reference Standards section to include latest standards and revisions. 

3. Added paragraph to "Relationship to TIA" subsection explaining distinction between 
functions intended for either appHcation use, terminal management use, or 
communications use. Included entity functions are intended to be used by in individual 
function descriptions. 

4. Added note to definition of Device Status Report in terminology section to distinguish 
DSRs used for Terminal Management versus others. Some Device Status Reports are 
properly part of Terminal Meuaagement, while others pertain to presentation state or 
input processing. 

5. Added definitions for "Factoiy Default State", "Power-Up State", and "Tertiary Device 
Attributes" in terminology section. 

6. Recoded all algorithms in VAX— 11 C to match new Code Extension section. 

7. Updated algorithms and state information throughout to include Level 3 and Level 4 
Character Cell Display Service Class. 

STATE DESCRIPTIONS: 
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8. Added note explaining the status of the algorithms at the beginnii^ of the State 
Descriptions subsection. Algorithms should be viewed the same as other text. 

9. Added "terminal unit ID" to device identification information available at Level 4. 

10. Updated hst of extensions. 

INITIALIZATION: 

11. Updated Hst of features that may be initialized from NVM to include VTSOO and 
VT400 capabiHties. Removed "keypad_mode" to reflect actual implementation in the 
VT100Anr200A7T300. Ke 3 T)ad mode is not stored in NVM. 

12. Combined Control String extensions as a single enumerated type since it is not possible 
to be in more than one control string at a time. 

13. Added character_set_mode for NRCS extension. 

14. Included parser initialization from Code Extension section. 

15. Added data integrity flags as defined for VT400. 

16. Added virtual terminal configuration (vt_configuration) as used in VT420 to control 
multiple sessions. 

17. Added page number, lines_per_page, columns_per_page, and cursor coupling to support 
Windovnng Extension as implemented by VT330,VT340, and VT420. 

18. Added state information for horizontal scroUing: left_margin, right_margin, left_right_ 
margin_mode. 

19. Added area extent mode (stream versus rectangular) for rectangular area operations. 

20. Added state for selecting status display t 3 rpe and active display. 

21. Expanded keyboard state to include: keyboard_usage_mode, send_receive_mode, 
backarrow_key_mode, compose_key_mode, alt_key_mode, keyboard_encoding_mode 
(character versus position), and local controls for F1-F5. 

22. Added printer_to_host per VT240, and printer_assignment for multiple sessions. 

23. Added code to initiaHze set-up features that are not setable from the host but that 
affect the description of other functions. 

CONTROL FUNCTIONS; 

24. Clarified that higher conformance levels do not have to be strict supersets of lower 
levels, and that conforming software must select a known conformance level. 

25. Clarified in the text that the primary DA reports extensions supported at the current 
operating level. If higher conformance levels subsume extensions previously reported 
at lower levels, these extensions must still be reported at the lower level to ensure 
existing software can recognize them. 

26. Added concept of "Implicit Extensions" so software can recognize features defined at 
a higher conformance level which are not disabled at lower levels. Listed impHcit 
extensions created by Level 2 and Level 3. Removed note that DECSCL was the only 
exception to rule that features defined at higher levels must be disabled at lower levels. 
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Implicit extensions ensure software can still recognize which features are present, and 
corresponds to actual 'VT200 and VTSOO implementations. 

27. Noted that DECID (ESC Z) is not recognized at Level 3 or higher. 

28. Added description of Secure Reset function. 

29. Updated DECSTR (Soft Terminal Reset) to reflect newer implementations as follows: 
Bottom margin is set to number of lines on page; left and right margins are reset; auto 
wrap mode is recalled from NVR; current attribute is set to not selective erasable; 8-bit 
multinational characters are selected; the main display is selected (status display is 
exited); the User Preference Supplemental Set (UPSS) is recalled from NVM; keyboard 
encoding mode is reset to character (VT420); Added macro definitions to list of state 
not affected (VT420). 

30. Added Device Status Reports for data integrity and Virtual Terminal State (VT420). 
Noted that other DSRs are not part of terminal management. 

31. Added note that DSR has been processed asynchronously ahead of other data in the 
input buffer on hardcopy devices (guideline). 
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APPENDIX A REFERENCED DOCUMENTS 


A.1 EL-Class Digital Documents 

EL-Ctass Number 

Document Title 

EL-00070-05 

EL-00070-07 

EL-00070-0A 

EL-00070-0D 

EL-00138-00 

DEC STD 070-5 Video Systems Reference Manual - Character Cell Display 

DEC STD 070-7 Video Systems Reference Manual - Printer Port Extension 

Video Systems Reference Manual - VT52 Emulation 

Video Systems Reference Manual - Documented Exceptions 

DEC STD 138-0 Registry of Control Functions for Character Imaging Devices 


Use VTX SMC to order copies of EL-class documents from Standards and Methods Control. 
Send distribution questions to JOKUR::SMC or call DTN: 287-3724. 
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APPENDIX B RELATED DOCUMENTS 


B.1 EL-Class Digital Documents 

EL-Class Number Document Title 

EL-00070-01 DEC STD 070-1 Video Systems Reference Manual - Concepts and Conformance 

Criteria 

EL-00169-00 DEC STD 169-0 DEC Standard Coded Graphic Character Sets for Hardware and 

Software 


Use VTX SMC to order copies of EL-class documents from Standards and Methods Control. 
Send distribution questions to JOKUR::SMC or call DTN: 287-3724. 


B.2 Other Documents 

Document Number Document Title 


ANSI X3.4 - 1986 
ANSI X3.41 - 1974 

ANSI X3.64 - 1979 

DPANS X3.1 34.1 -1985 
DPANS X3.1 34.2-1 985 
ISO 2022:1986 

ISO 6429:1988 
ISO 646 

ISO 8859-1:1987 


American National Standard Code for Information Interchange (ASCII Character Set) 

American National Standard Code Extension Techniques for use with the 7-Bit Coded 
Character Set of the American National Standard Code for Information Interchange 
Additional Controls for use with American National Standard Code for Information 
Interchange 

S-Bit ASCII Structure and Rules 

7-Bit and d-Bit ASCII Supplemental Multinational Graphic Character Set 

information Processing / ISO 7-Bit and d-Bit Coded Character Sets - Code Extension 
Techniques 

information Processing / Additional Controls for use with Character Imaging Devices 
7-Bit Coded Character Set for Information Interchange 

Information Processing / d-Bit Single-Byte Coded Character Sets - Part 1 : ISO Latin 
Alphabet Nr 1; 


B.3 Ordering Information 

Following are the sources for documents not available from Standards and Methods 
Control. 

• ANSI, lEC, and ISO Documents 

American National Standards Institute (ANSI), 

1430 Broadway, New York, NY 10018 
Telephone (212) 354-3300 x479 
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5.1 INTRODUCTION 

5.1.1 Purpose 

This section defines the interface to a Character Cell Display 
device. A Character Cell Display device is a device capable of 
character imaging output. In addition to the physical 
presentation of graphic characters, it must provide certain 
control functions for defining the format and rendition of the 
information presented. 

The Character Cell service class consists of operations that image 
or format characters that are addressed on the imaging surface 
using a character cell addressing capability. All Character Cell 
operations are either graphic (printing) characters or control 
functions (control characters, escape sequences, control 
sequences, or control strings) according to the structure of ANSI 
X3.41, Code Extension Techniques for use with ASCII, and ANSI 
X3.64, Additional Control Functions for use with ASCII. 

Character Cell Display devices are distinguished from Character 
Cell Printing devices by their ability to perform certain dynamic 
operations, such as inserting characters within text, erasing 
previously displayed characters, and blinking. 

The Character Cell Display service class consists of operations 
that ; 

1. image characters on a two-dimensional display surface 
that represent text or picture drawing symbols, 

2 . alter their position after receipt 

3. remove them from the display, and 

4. cause them to be re-transmitted. 

The intent of the Character Cell Display service class is to be 
implementable using a character generator or a minimum of a single 
plane image memory. 


5.1.2 Scope 

This section applies to all DEC products which implement these 
interfaces and are intended to be certified as conforming to the 
Terminal Interface Architecture. It also applies to software 
which is intended to use these interfaces in a conforming manner. 
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5.1.3 Relationship To TIA 

The Character Cell interface forms a service class of the 
Presentation Service Class layer of the Terminal Interface 
Architecture . It is independent of the other layers of the 
architecture, and has no explicit relationship to other service 
classes within the Presentation Service Class layer. 
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The interfaces defined within this specification apply to both 
internal and external product interfaces. External interfaces are 
interfaces between a terminal, personal computer or workstation 
and a remote system. Internal interfaces are interfaces between a 
terminal sub-system and software processes running within a 
terminal, personal computer or workstation. 
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5.1.4 Organization 

To simplify understanding the Character Cell Display service 
class, this section is divided into a number of largely 
independent subsections which describe functionally related parts 
of the ANSI host interface. These subsections are: 

Display Coordinate System and Addressing 

Window Management 

Visual Attributes and Renditions 

Audible Indicator 

Graphic Character Sets 

Summary of Control Character Processing 
Mode States 
Editing Functions 
OLTP Features 

Saving and Restoring Terminal State 

Other sections of the VSRM also describe parts of the ANSI host 
interface . 


5 . 2 TERMINOLOGY 

Active Position - (1) The character position in a visual display 
that is to image the graphic symbol representing the next graphic 
or control character for which a graphic representation is 
required (2) The character position in a logical display which 
contains the character code, graphic rendition, and character set 
of a graphic or control character for which a graphic 
representation is required. 

Advance - To move the active position in the direction of 
increasing horizontal character position in a visual or logical 
display . 

Application - A hardware or software implementation of a process 
or a device . 

Application Program - A program that runs under control of an 
operating system. 
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Audible Indicator - A warning "bell", or similar indicator 
suitable to signal the operator' s attention, primarily to warn of 
certain error conditions. There are four functional categories of 
bells in conforming terminals: Right Margin Bell, Warning Bell, 
Required Error Bells, and Selectable Error Bells. 

Backward - In the direction of decreasing horizontal character 
position in a visual or logical display. 

Blind Interchange - Information interchange in which no prior 
agreements between sender and recipient are necessary in order to 
achieve successful interpretation of the information, except 
agreed-upon standards . 

CO Set - A set of 32 control characters allocated to columns 0 and 
1 of a code table. 

Cl Set - A set of 32 control characters allocated to columns 8 and 
9 of an 8 -bit code table, or represented as ESCape Fe sequences in 
7 -bit environment with identical meaning. 

Character Attribute - An attribute value which may be applied to a 
character position, which affects its subsequent processing, as in 
editing or retransmission. 

Character Imaging Device - A device that gives a visual 
representation of data in the form of graphic symbols using any 
technology, such as a on a cathode ray tube. In this 
specification the term "character imaging device" does not apply 
to hard copy devices (printers) which are not capable of dynamic 
editing and reformatting of the displayed information. 

Character Position - (1) The portion of a visual display that 
images or is capable of imaging a graphic symbol. (2) An 
addressable element in a logical display containing sufficient 
information to render a graphic symbol, including the character 
code, visual attributes, logical attributes, and character set 
designation . 

Character Rendition - An attribute value which may be applied to a 
character position, which affects its visual representation (see 
Graphic Rendition) . 

Control - A control character, an escape sequence, or a control 
sequence that performs a control function. 

Control Sequence Introducer (CSI) - The Cl control (represented by 
a single character in 8 -bits, or a two character ESC Fe sequence 
in 7-bits) which initiates a control sequence. CSI is a prefix 
affecting the interpretation of a limited number of contiguous bit 
combinations . 

Cursor, Cursor Symbol - A visual (blinking or non-blinking) 
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symbol, usually a rectangle, diamond or underline that indicates 
the Active Position on the display. 

. Cursor Control - An editing function that moves the active 
position . 

Default - A function-dependent value that is assumed when no 
I explicit value, or a value of 0, is specified. 

Delete - To remove displayed symbols and close up adjacent graphic 
symbols to fill the gap. 

Designate - To identify a set of characters that are to be 
represented in a prescribed manner, in some cases immediately and 
in others on the occurrence of a further control function. 

Display - The area for visual presentation of data on cathode ray 
tube and similar character imaging devices. In this specification 
the word "display" will always be qualified by the terms 
"physical" (or "visual") and "logical", to differentiate between 
the actual presentation surface and memory buffers containing 
information to be presented. 

Editor Function - A control that affects the layout or positioning 
of previously entered or received information in a character 
imaging device and is intended to be interpreted without remaining 
in the data stream. See Format Effector. 

Empty Character - A character position in the logical display in 
which no character code appears, and thus no character is rendered 
in the visual display for this position. In an empty character 
position the character rendition, character attribute, and 
character set values should be ignored. 

Enter - To input information manually into a character imaging 
device or to read information from an auxiliary device into a 
character imaging device . 

Erase - To remove displayed graphic symbols without closing up 
adjacent symbols to fill the gap. 

Fixed Space - A character that normally has no graphic 
representation, occupies a character position in a visual display, 
and is usually encoded as bit combination 2/0. 

Following - Lines or character positions in the visual display 
with larger numbered lines or larger numbered character positions 
than that of the active position. 

Font - A complete assortment of displayable graphic symbols in one 
size or style. 

Format Effector - A control that effects the layout or positioning 
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of information in a character imaging device and may remain in the 
data stream subsequent to interpretation and processing. See 
Editor Function. 

Forward - In the direction of increasing horizontal character 
position in a visual display. 

Graphic Character - A character, other than a control character, 
that has a visual representation normally handwritten, printed, or 
displayed. 

Graphic Rendition - A visual style of displaying a set of graphic 
symbols . 

Graphic Symbol - A visual representation of a graphic character or 
a control for which a graphic representation is required. 

Invoke - To cause a designated set of characters to be represented 
by the prescribed bit combinations whenever those bit combinations 
occur until an appropriate code extension function occurs. 

Line - A set of adjacent character positions in a visual display 
that have the same vertical position. 

I Logical Display - the lines and columns available for storing and 
I presenting graphic characters as seen by the application or host 
I computer. A Logical Display may be organized as a single 
I rectangular array of lines and columns (one page) , or divided into 
I a number of identically sized pages, each of which is a 
I rectangular array of lines and columns . 

I Margin - A line which marks the upper or lower boundary of the 
I scrolling region (vertical scroll margin) . A column which marks 
I the left or right boundary of the scrolling region (horizontal 
I scroll margin) . 

Mode - A state of a device, or other sender or recipient, that 
affects the interpretation of received information, the operation 
of the sender or recipient, or the format of the transmitted 
information . 

Next - See Following. 

Operating System - Software that controls the execution of 
computer programs and may provide scheduling, debugging, 
input/output control, accounting, compilation, storage assignment, 
data management, and related services. 

I Page - An addressable area of a Logical Display organized as a 
I rectangular array of lines and columns . The number of lines and 
I columns defines the Page Size. 

Preceding - Lines or character positions in a visual display with 
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smaller numbered lines or smaller numbered character positions 
than that of the active position. 

Private Use - A technique of encoding or representing information 
in a prescribed, but nonstandard, way. 

Received Data Stream - The stream of bit combinations received by 
a character imaging device for purposes of information 
interchange . 

Represent - (1) To use a prescribed bit combination with the 
meaning of a character in a set of characters that has been 
designated and invoked. (2) To use an escape sequence with the 
meaning of an additional control character. 

Scroll - An action whereby all of the graphic symbols of a visual 
display are moved in a specified direction. 

String Delimiter - A control that begins or ends a string of 
characters in a data stream. 

Tabulation - A technique of identifying character positions in a 
visual display for the purpose of arranging information 
systematically . 

Tabulation Stop - An indication that a character position is to be 
used for tabulation. 

Transmit - To send data as a data stream for purposes of 
information interchange. 

Transmitted Data Stream - The stream of bit combinations sent by a 
character imaging device when it is induced to transmit for 
purposes of information interchange. 


5.2.1 Code Extension Terms 

This chapter also uses the following terms which are defined in 
the "Code Extension Layer" section of the VSRM (DEC STD 70-3) : 

Bit Combination 
Character 
Control Character 
Control Function 
Control Sequence 
Control String 
Escape Character (ESC) 

Escape Sequence 
Final Character 
Intermediate Character 
Numeric Parameter 
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I Parameter 

I Parameter String 

I Selective Parameter 
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5.3 CHARACTER CELL DISPLAY STATE DECLARATIONS 

/************** module char cell types. h *************/ 

/* 

* type declarations for character cell display state 

* PAS 28-Jul-1989 
*/ 

typedef enum { JUMP, SLOW } scrolling_mode_t ; 

typedef enum { NORMAL_SCREEN, REVERSE_SCREEN } screen_mode_t / 
typedef enum { WRAP_OFF, WRAP_ON } auto_wrap_mode_t ; 
typedef enum { TEXT_CURSOR_OFF, TEXT_CURSOR_ON } 
text_cursor_enable_mode_t ; 

typedef enum { INSERT, REPLACE } insert_replace_mode_t ; 

typedef enum { NEW_LINE_OFF, NEW_LINE_ON } new_line_mode_t / 

typedef short int line_t; 

typedef short int column_t/ 

typedef short int page_t; 

typedef struct 

{ /* character_position_t */ 

line_t line; 
column_t column; 
page_t page; 

} character_position_t ; 
typedef enum { TRUE, FALSE } boolean_t; 
typedef struct 

{ /* character_rendition_t */ 

boolean_t bold; 
boolean_t blink; 
boolean_t underscore; 
boolean_t reverse; 

} character_rendition_t; 
typedef struct 

{ /* character_attribute_t */ 

boolean_t select ive_erase; 

} character_attribute_t ; 
typedef enum 

{ /* line_rendition_t */ 

DOUBLE_HE IGHT_TOP , 

DOUBLE_HE I GHT_BOT TOM , 

SINGLE_WIDTH, 

DOUBLE_WIDTH 
} line_rendition_t ; 
typedef struct 

{ /* character_t */ 

short int code; 

char act er_rendit i on_t rendition; 
character_attribute_t attribute; 
graphic_character_set_t character_set ; 

} character_t; 
typedef struct 

{ /* char_set_designator_t */ 

graphic_character_set_t name; 
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short int f irst_intermediate; /* 0-47, 0=no intermediate */ 

short int second_intermediate; /* 0-47 */ 

short int final; /* 0 indicates null entry */ 

} char_set_de s ignat or_t ; 

typedef enum { ABSOLUTE, DISPLACED } origin_mode_t ; 
typedef struct 

{ /* save_buffer_t */ 

character_position_t position; 
character_rendition_t rendition; 
or igin_mode_t or igin_mode ; 
graphic_character_set_t left; 
graphic_character_set_t right; 
graphic_character_set_t gO; 
graphic_character_set_t gl ; 
graphic_character_set_t g2; 
graphic_character_set_t g3; 
character_attribute_t attribute; 

} save_buf fer_t ; 

typedef enum { EIGHTY, ONE_THIRTY_TWO } column_mode_t ; 
typedef enum { UNCOUPLED, COUPLED } cursor_coupling_mode_t ; 
typedef enum { FIXED, SETABLE } left_right_margins_mode_t ; 
typedef enum { STREAM, RECTANGULAR } area_extent_t ; 
typedef short int lines_per_page_t; /* 24, 25, 36, 72, 144 */ 

typedef short int columns_per_page_t ; /* 80, 132 */ 

typedef short int number_of_j3ages_t ; /* 1, 2, 3, 4, 5, 6 */ 

/************ end of char_cell_types .h ****************/ 


/************** module char cell extern. h *************/ 

/* " “ 

* external storage declarations for character cell display state 

* PAS 28-Jul-1989 
*/ 

fdefine MAX_NUM_LINES 73 
Idefine MAX_NUM_COLUMNS 133 
fdefine EMPTY_CHARACTER 0 
fdefine MAX_NUM_CHAR_SETS 8 
/* character set table entries */ 
fdefine TABLE_ASCII 0 
fdefine TABLE_LINE_DRAWING 1 
fdefine TABLE_DEC_SUPP 2 
fdefine TABLE_NRCS 3 
fdefine TABLE_LATIN1 4 
fdefine TABLE_UPSS 5 
fdefine TABLE_TCS 6 
fdefine TABLE_DRCS 7 

/* Note DRCS must be last in search order 
to replace others if identical */ 


ext character t 
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display [MAX NUM LINES] [MAX NUM COLUMNS]; 


Horiz 

Horiz 


ext line_rendition_t 
ext character_^osition_t 
ext line_t 
ext line_t 
ext column_t 
ext coluinn_t 
ext boolean_t 
ext active_display_t 
ext status_display_t 
ext char_set_designator_t 
ext save_buf fer_t 
ext char act er_rendition_t 
ext character_attribute_t 
ext boolean_t 
ext coluiiin_mode_t 
ext lines_per_page_t 
ext columns_per_j>age_t 

ext number_of_pages_t number_df_pages; 

ext scrolling_mode_t scrolling_mode; 

ext screen_mode_t screen_mode/ 

ext origin_mode_t origin_mode; 

ext auto_wrap_mode_t auto_wrap_mode; 

ext text_cursor_enable_mode_t text_cursor_enable_mode; 
ext insert_replace_mode_t insert_replacement_mode; 
ext new_line_mode_t new_line_mode; 

ext cursor_coupling_mode_t 

horizontal_cursor_coupling, 
vertical_cursor_coupling, 
page_cursor_coupling; 
ext left_right_margins_mode_t 

left_right_margins_mode; /* Horiz Scroll */ 
ext area_extent_t 

attribute change extent; /* 


scroll 

scroll 


ext 

ext 


*/ 

*/ 


line_rendition[MAX_NUM_LINES] ; 
ac t i ve_po s i t i on ; 
top_margin; 
bott om_margin ; 
left_margin; /* 
right_margin; /* 

1 a s t_c o lumn_f 1 ag ; 

act ive_di splay; /* L3 or Status Dsply*/ 
status_di splay; /* L3 or Status Dsply*/ 
char_set_table [MAX_NUM_CHAR_SETS] ; 
cursor_save_buf fer; 
cur r ent_rendit ion; 

current_attribute; /* Selective Erase*/ 
horizontal_tab_stops [MAX_NUM_COLUMNS] ; 
column_mode; /* 132 Column Ext */ 

lines_per_j)age; /* Windowing */ 
columns_per_page; /* Windowing */ 

/* Windowing 


7 


/* Windowing */ 
/* Windowing */ 
/* Windowing */ 


_ _ L4 

/********** end of char cell extern. h 


or rect editing */ 

***?t***7lc*7l:**:*c ! 


/* function declarations */ short int end_of_line () ; void 
scroll_up(); void scroll_down () ; void scroll_left () ; void 
scroll_right 0 ; void insert_or_replace_character () ; void 
selective_erase_in_line 0 ; void selective_erase_in_display () ; 


5.3.1 Notes On Character Cell Display State 


a. An empty character is a character position in the Logical 
Display in which no character code appears, and thus no 
character is rendered in the visual display for this 
position. In this implementation this is handled by a 
null entry in the logical display structure, which should 
be rendered as a space with normal rendition in the 
visual display. In other implementations this may be 
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handled in a manner appropriate to the display list 
structure, but the affect on the visual display should be 
the same . 

In an empty character position the character rendition, 
character attribute, and character set values should be 
ignored. 

b. The number of character sets available depends on the 
conformance level and architecture extensions present. 

See "Character Set Repertoire" in this chapter (DEC STD 
70-5) . 


See the "Terminal Management" Section (DEC STD 70-4) for a listing 
of all terminal state, and initialization procedures. 
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5.4 DISPLAY COORDINATE SYSTEM AND ADDRESSING 
5.4.1 Logical Display 

A conforming device shall provide the capability of storing and 
presenting single-width graphic characters in a rectangular array 
of lines and columns called a Logical Display Page. The number of 
lines and columns shall define the size of the Logical Display 
Page, or Page Size. The entire Logical Display may consist of a 
single page, or a number of pages of identical size. 

All conforming devices shall support a single Logical Display Page 
of 24 lines by 80 columns, extendable to 24 lines by 132 columns 
when the "132 Column Mode" extension is present (DECCOLM, see 
"Page Size and Arrangement") . 

Level 4 devices, and Level 3 devices with the "Windowing 
Extension" shall support commands to change the Logical Display 
Page Size (DECSLPP and DECSCPP, see "Page Size and Arrangement") . 
The actual Page Sizes supported shall be clearly specified in the 
product documentation, and means shall be provided for software to 
interrogate the size of the Logical Display Page. The Page Size 
and number of pages in the Logical Display may also be 
configurable by the user under local control. 

Each character position in the Logical Display will consist of the 
following information: a character code, a character rendition, 
character attributes, and a character set. 

The first position in a logical display page shall be at line 1, 
column 1. Frequently this will correspond to the upper left 
corner of the physical display with line numbers increasing 
downward, and column numbers increasing to the right, but this 
need not be true . 

The graphic representation of each character on the physical 
display surface will occupy a rectangular cell whose lower left 
hand corner is at the logical screen coordinate corresponding to 
the position of the character in the the array. 
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Display Structure and Addressing 


5.4.2 Active Position And Cursor 

A conforming device shall maintain the line and column coordinates 
of a single character position, known as the "Active Position", 
which serves as a reference point for character insertion and 
replacement as well as various control functions . The Active 
Position indicates the character position at which the next 
operation is to begin. 

The Active Position does not necessarily correspond to the visual 
indicator in the physical display known as the "Cursor Symbol". 
However, in this specification the terms "Active Position" and 
"Cursor" are used interchangeably in order not to conflict with 
previous usage. 
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SET/RESET TEXT CURSOR ENABLE MODE DECTCEM 

Levels: 2-4 

Purpose: Select whether the text cursor symbol in the display has 

a visual representation. 


Set Format: CSI ? 25 h 

Reset Format: CSI ? 25 1 


Description: A conforming device shall provide a means of 

enabling or disabling the visible cursor symbol. This mode shall 
apply only to the text cursor symbol implemented by the Character 
Cell Display service class. In the set state (Text Cursor On), 
which is the default, the text cursor symbol will be displayed. 

In the reset state (Text Cursor Off) , the text cursor symbol will 
not be displayed. 

When a request is received to turn off the cursor, it will be done 
immediately (if not already off) . If a request is received to 
enable the cursor, and the cursor is not already on, the cursor 
will remain off for a small "initial" cycle, after which it will 
become visible and begin its normal blinking cycle. This makes 
the cursor blink with a steady duty cycle regardless of how fast 
it is turned on and off. 

Notes : 

1. There is some concern that a program might inadvertently 
leave the text cursor turned off. It is suggested that 
entering SETUP mode will always turn on the text cursor 
while in SETUP mode, but that normally it be restored to 
its previous state upon exiting SETUP mode. Also, a 
means should be provided in SETUP mode to force the text 
cursor to be re-enabled. 


State Affected: 


text cursor enable mode 
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Algorithm: 


void set_text_cursor_enable_mode () 

{ 

if (conformance_level >= LEVEL_2) 

text_cursor_enable_mode = TEXT_CURSOR_ON; 

} 


void reset_text_cursor_enable_mode () 

{ 

if (conf ormance_level >= LEVEL_2) 

text_cursor_enable_mode = TEXT_CURSOR_OFF; 

} 


Known Deviations : None 



VSRM - Character Cell Display EL-00070-05 Page 5-23 

Digital Internal Use Only - For Review Only 29-Jun-1990 


5.4.3 Margins And Scrolling 

A conforming device shall provide the capability of defining top 
and bottom margins of a scrolling region. The top and bottom 
margins are two line numbers in a logical display page. The top 
margin must always have a lower line number than the bottom 
margin . 

Devices with the Horizontal Scrolling Extension shall provide the 
ability to define left and right margins of a scrolling region. 

The left and right margins are two column numbers in a logical 
display page. The left margin must always have a lower column 
number than the right margin . 

Numerous editing and cursor control functions are defined relative 
to the scrolling margins. 

The default scrolling region at power-up or after reset is equal 
to the size of the logical display page. 
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Margins and Scrolling Region 


A scrolling region is defined as the area bounded by the top, 
bottom, left, and right margins, which are set by DECSTBM and 
DECSLRM. All scrolling, both vertical and horizontal, is limited 
to this area. 


Several controls are ignored or behave differently if the active 
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position is outside certain boundaries of the scrolling region. 
The following table lists these controls: 

margins 



T/B 

L/R 




+- 

+ - 





DCH 1 

0 

X 

1 

X 

= Is affected. 

ICH 1 

0 

X 

1 


Does not work outside 

1 



1 


these margins . 

DL 1 

X 

X 

1 



IL 1 

X 

X 

1 

0 

= Not affected. 

1 



1 


Continues to work outside 

DECDC 1 

X 

X 

1 


these margins . 

DECICI 

X 

X 

1 



1 



1 

* 

= If active position is inside margins, 

IND 1 

* 

0 

1 


affect is limited by margins. 

RI 1 

* 

0 

1 


If active position is outside margins. 

DECBI 1 

0 

* 

1 


control still has an affect. 

DECFI 1 

0 

iz 

1 


but no scrolling can occur. 

+ - 

+- 



-+ 




The following functions described in this subsection are used to 
control scrolling: 


DECSTBM 

Set Top and Bottom Margins 

DECSLRM 

Set Left and Right Margins 

DECLRMM 

Left Right Margin Mode 

DECOM 

Origin Mode 

DECSCLM 

Scrolling Mode 

IND 

Index 

RI 

Reverse Index 

DECFI 

Forward Index 

DECBI 

Back Index 
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SET TOP AND BOTTOM MARGINS DECSTBM 


Levels: 1-4 

Purpose: Change the top and bottom margin settings for the 

scrolling region. 


Format: CSI Pt ; Pb r default Pt : 1 

9/11 Pt ; Pb 7/2 default Pb: last line 


Description: The DECSTBM control sets the values of the Top and 

Bottom Margins of the scrolling region. The new settings are 
determined by the parameter values. The first parameter sets the 
value of the Top Margin, and the second parameter sets the value 
1 of the Bottom Margin. The default settings if either or both 
I parameters are omitted are the boundaries of the Logical Display 
I Page: one (1) for the Top Margin and twenty-four (24) for the 
1 Bottom Margin when the Page Size is 24 lines. 

Notes : 

I 

I 1. Execution of this control causes the Active Position to 

I be set to the page origin obeying Origin Mode (DECOM) : 

I First column of first line if Origin Mode is in the reset 

I (Absolute) state; Top and Left Margins if Origin Mode is 

I in the set (Displaced) state. 

2. If the value specified for the Top Margin is equal to or 
greater than the value specified for the Bottom Margin, 
this control will be ignored (not executed) . 

1 

I 3. If the value specified for the Bottom Margin is greater 

1 than the number of lines in the Logical Display Page, 

I this control will be ignored (not executed) . 


State Affected: 

active_position 
top_margin 
bot t om_mar gin 
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Algorithm: 

void set_top_and_bottom_margins (parv) 
short int parv [MAX_NUM_PARAMETERS] ; 

{ 

/* use defaults for omitted parameters */ 
if (parv[0] == 0) parv[0] =1; 

I if (parv[l] == 0) parv[l] = lines_per__page; 

I 

I if ((parv[0] < parv[l]) && (parv[l] <= lines_per_page) ) 
{ 

top_margin = parv[0]; 
bottom_margin = parv[l]; 
if (origin_mode == ABSOLUTE) 

{ 

active_position . line =1; 
act ive_pos it i on . column = 1; 

} 

else 

{ 

active_position . line = top_margin; 

I act ive_j30 sit ion . column = left_margin; 

} 

} 

} 


Known Deviations: None 
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SET LEFT AND RIGHT MARGINS DECSLRM 


Levels: 4x (Horizontal Scrolling) 

Purpose: Change the left and right margin settings for the 

scrolling region. 


Format: CSI PI ; Pr s default PI: 1 

9/11 PI ; Pr 7/3 default Pr: Last Column 


Description: The DECSLRM control sets the values of the Left 

and Right Margins of the scrolling region. The new settings are 
determined by the parameter values. The first parameter sets the 
value of the Left Margin;^ "and the second parameter sets the value 
of the Right Margin. The default settings if either or both 
parameters are omitted are the boundaries of the Logical Display 
Page: one (1) for the Left Margin and eighty (80) for the Right 

Margin when the Page Size is 80 columns wide. 

Notes : 

1. Execution of this control causes the Active Position to 
be set to the page origin obeying Origin Mode (DECOM) : 
First column of first line if Origin Mode is in the reset 
(Absolute) state; Top and Left Margins if Origin Mode is 
in the set (Displaced) state. 

2. If the value specified for the Left Margin is equal to or 
greater than the value specified for the Right Margin, 
this control will be ignored (not executed) . 

3. If the value specified for the Right Margin is greater 
than the number of columns in the Logical Display Page, 
this control will be ignored (not executed) . 

4. This control function is only recognized when DECLRMM 
(Left Right Margin Mode) is set. 

5. Setting the margins to other than their default values 
(the boundaries of the Logical Display Page) may disable 
smooth scrolling (DECSCLM) . 


State Affected: 

active_position 

left_margin 

right_margin 
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Algorithm: 

void set_left_and_right_margins (parv) 
short int parv [MAX_NUM_PARAMETERS] ; 

{ 

if ( (conf ormance_level == LEVEL_4) && 

(level_4_extensions [HORIZONTAL_SCROLL] == TRUE) && 
(left_right_margins_mode == SETABLE) ) 

{ 

/* use defaults for omitted parameters */ 

if (parv[0] == 0) parv[0] = 1; 

if (parv[l] == 0) parv[l] = columns_per_page / 

if ((parv[0] < parv[l]) && (parv[l] <= columns_per_page) ) 

{ 

left_margin = parv[0]; 
right_margin = parv[i]/ 
if (origin_mode == ABSOLUTE) 

{ 

active_position . line =1; 
active_position . column = 1/ 

} 

else 

{ 

active_position . line = top_margin; 
active_position . column = left_margin; 

} 

} 

} 

} 


Known Deviations : None 
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SET/RESET LEFT RIGHT MARGIN MODE DECLRMM 


Levels: 4x (Horizontal Scrolling) 

Purpose: Change the state of Left Right Margin Mode between Not 

Available (reset) and Available (set) . 


To set: CSI ? 69 h (Available) 

To reset: CSI ? 69 1 (Not Available - default) 


Description: DECLRMM is a parameter to the Set Mode and Reset 

Mode commands. In the reset state, the left and right scrolling 
margins in every page may not be moved through the DECSLRM 
command, they are set to be at the extremes of the page . In the 
set state, DECSLRM commands are recognized, however, no line 
attributes other than Single Wide may be used. 

When DECLRMM is set, all line attributes currently in Page Memory 
for the Session will be reset to Single Wide, Single High, and 
DECDWL and DECDHL escape sequences, to change the line attribute 
to Double Wide or Double Wide and High, will be ignored. 


State Affected: 

left_right_margins_mode 
line_rendition [MAX_NUM_LINES] 
left_margin 
right_margin 
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Algorithm: 

void set_left_right_margins_mode () 

{ 

int i ; 

if ( (conformance_level == LEVEL_4) && 

(level_4_extensions [HORIZONTAL_SCROLL] == TRUE) ) 

{ 

for (i=0; i<MAX_NUM_LINES; i++) 

{ 

line_rendition[i] = SINGLE_WIDTH/ 

} 

left_right_margins_mode = SETABLE; 

} 

} 


void reset_left_right_margins_mode () 

{ 

if ( (conf ormance_level == LEVEL_4) && 

(level_4_extensions [HORIZONTAL_SCROLL] == TRUE) ) 

{ 

left_margin = 1; 

right_margin = columns_per_page; 
left_right_margins_mode = FIXED; 

} 


Known Deviations : None 
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SET/RESET ORIGIN MODE DECOM 


Levels: 1-4 

Purpose: Change the state of Origin Mode between Absolute (reset) 

and Displaced (set) origin. 


To Set: CSI ? 6 h (displaced) 

To Reset: CSI ? 6 1 (absolute - default) 


Description: A conforming device shall allow addressing of the 

display area to be performed relative to either the display origin 
(coordinate 1/^1) [reset state = absolute] or the origin of the 
current scrolling region (Top Margin, Left Margin) [set state = 
displaced] . When Origin Mode is in the set state (displaced) , the 
Active Position cannot be moved above the Top Margin or left of 
the Left Margin of the scrolling region. 

The DECOM controls are used the change the state of Origin Mode 
between Absolute and Displaced. 


State Affected: 

origin_mode 

active_position 


Algorithm: 

void set_origin_mode 0 

{ 

origin_mode = DISPLACED; 

act ive_position . line = top_margin; 

1 active_position . column = left_margin; 

} 


void reset_origin_mode 0 

{ 

origin_mode = ABSOLUTE; 
active_position . line = 1; 
act ive_position. column = 1; 
} 


Known Deviations: None 
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SET/RESET SCROLLING MODE DECSCLM 


Levels: 1-4 

Purpose: Change the state of Scrolling Mode between Jump (reset) 

and Slow (set) scrolling. 


To Set: CSI ? 4 h (smooth - default) 

To Reset: CSI ? 4 1 (jump) 


Description: A conforming device shall provide the capability of 

selecting either jump scrolling [reset state = jump] and slow 
scrolling [set state = slow] . Jump scrolling is defined as 
scrolling of the display as fast as the device permits, to a 
maximum which will be implementation defined. Slow scrolling is 
defined as scrolling of the display at a rate of approximately 6 
text lines per second. The intention of slow scrolling is to move 
text through the display at a rate which makes it "recognizable", 
but not necessarily readable. (i.e., it is not guaranteed that it 
will appear slowly enough for the user to scan read the entire 
text) . The scrolling speed applies to vertical scrolling of the 
scrolling region of the display, which can be set as any 
combination of adjacent lines. 

The DECSCLM controls are used to change the state of Scrolling 
Mode between Jump (reset state) and Slow (set scrolling. 

Notes : 

1. Some implementations may offer a choice of additional 
scrolling speeds in Set-Up. The reset state of DECSCLM 
will select the speed closest to 6 lines per second. 

2 . Setting the left or right margins to other than their 
default values (the boundaries of the Logical Display 
Page) may temporarily disable smooth scrolling 
(guideline) , but will not affect the state of Scrolling 
Mode . 


State Affected: 


scrolling_mode 
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Algorithm: 

void set_scrolling_mode 0 

{ 

scrolling_mode = SLOW; 

} 


void reset_scrolling_mode 0 

{ 

scroll ing_mode = JUMP; 

} 


I Known Deviations: Workstation terminal emulators which do not 
I have scrolling hardware do not implement this control (DECterm, 
I UIS) . 
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INDEX 


IND 


Levels: 1-4 

Purpose: Move the Active Position downward one line, scrolling if 

necessary . 

Format : IND 

8/4 (ESC D) 

Description: The IND control moves the Active Position downward 

in the display by one line. If the Active Position is already at 
I the Bottom Margin the display will scroll upward by one line. If 
I the display scrolls, a blank line with all attributes off will 
I appear at the bottom margin. 

Notes : 

1 . If the Active Position is above the Bottom Margin when 
this control is executed, the Active Position will not 
move beyond the Bottom Margin. If the Active Position is 
below the Bottom Margin (as the result of absolute cursor 
positioning) it will still move downward by one line and 
no scrolling will occur. In this case, the Active 
Position will not move beyond the bottom line of the 
display. 

2. This control is identical to the Line Feed (LF) control, 
except that it is not affected by the setting of New Line 
Mode . 

State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 
active_j)Osition 

Algorithm: 

void index 0 

{ 

if ( act ive_po sit ion . line == bottom_margin) 
scroll_up (top_margin, 1); 
else 

I if (active_position . line < lines_per_page) 
act ive_j>osition. line += 1/ 

/* new line may have a different length - adjust column */ 
if ( act ive_posit ion . column > end_of_line (act ive_po sit ion . line) ) 
active_position . column = end of line (active position . line) ; 


} 
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Known Deviations : 

On the VTIOO and VT125, Index is affected by the setting of New 
Line Mode, in the same manner as Line Feed. 
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REVERSE INDEX RI 


Levels: 1-4 

Purpose: Move the Active Position upward one line, scrolling if 

necessary . 


Format : RI 

8/13 (ESC M) 


Description: The RI control moves the Active Position upward in 

the display by one line. If the Active Position is already at the 
1 Top Margin the display will scroll downward by one line. If the 
I display scrolls, a blank line with all attributes off will appear 
I at the top margin. 

Notes : 

1 . If the Active Position is below the Top Margin when this 
control is executed, the Active Position will not move 
beyond the Top Margin. If the Active Position is above 
the Top Margin (as the result of absolute cursor 
positioning) it will still move upward by one line and no 
scrolling will occur. In this case, the Active Position 
will not move beyond the first line of the display. 


State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 
active_position 

Algorithm: 

void reverse_index ( ) 

{ 

if (active_position . line == top_margin) 
scroll_down (top_margin, 1); 
else 

if (active_position . line > 1) 
active_jposition . line -= 1; 

/* new line may have a different length - adjust column */ 
if (active^osition . column > end_of_line (active_position . line) ) 
active_position. column = end_of_line (active_position . line) ; 

} 


Known Deviations: None 
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FORWARD INDEX DECFI 

Levels : 4x (Horizontal Scrolling) 

Purpose: Move the Active Position forward one column, scrolling 

if necessary. 


Format : ESC 9 

1/11 3/9 


Description: The DECFI control causes the active position to move 

forward one column. If the active position was already at the 
right margin, the contents of the Logical Display Page within the 
right, left, top and bottom margins shifts left one column. The 
column shifting beyond the left margin is deleted. A new column 
is inserted at the right margin with all attributes turned off and 
the cursor appears in this column. 

If the active position is outside the left or right margin when 
the command is received the active position moves forward one 
column. If the active position was at the right edge of the page, 
the command is ignored. 

Notes on DECFI : 

1 . Lines of text are shifted one column regardless of their 
line attributes. This means double-wide and double-size 
lines will appear to shift twice as fast as single-width 
lines . 


State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 
active_position 
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Algorithm: 

void decfiO 

{ 

if ( (conf ormance_level == LEVEL_4) && 

(level_4_extensions [HORIZONTAL_SCROLL] == TRUE) ) 

{ 

if (active_position . column == right_margin) 
scroll_left (left_margin, 1); 
else 

if (active_position . column < columns_per_page) 
act ive_position . column += 1; 

/* active line may not be columns_per_page long */ 
if (active_position . column > end_of_line (active_position . line) ) 
active_position . column = end_of_line (active_position . line) / 

} 

} 


Known Deviations : None 
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BACK INDEX DECBI 


Levels: 4x (Horizontal Scrolling) 

Purpose: Move the Active Position backward one column, scrolling 

if necessary. 

Format : ESC 6 

1/11 3/6 


Description: The DECBI control causes the active position to move 

backward one column. If the active position was already at the 
left margin, the contents of the Logical Display within the left, 
right, top and bottom margin shifts right one column. The column 
shifted beyond the right margin is deleted. A new column is 
inserted at the left margin with all attributes turned off and the 
cursor appears in this column. 

If the active position is outside the left or right margin when 
the command is received the active position moves backwards one 
column. If the active position was at the left edge of the page, 
the command is ignored. 

Notes on DECBI : 

1. Lines of text are shifted one column regardless of their 
line attributes. This means double-wide and double-size 
lines will appear to shift twice as fast as single-width 
lines . 


State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 
active_position 

Algorithm: 

void decbi () 

{ 

if ( (conf ormance_level == LEVEL_4) && 

(level_4_extensions [HORIZONTAL_SCROLL] == TRUE) ) 

{ 

if (active_position. column == left_margin) 
scroll_right (left_margin, 1); 
else 

if ( act ive_pos it i on . column > 1) 
active_position . column -= 1; 

} 

} 


Known Deviations : None 
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5.4.4 Cursor Movement 

This section describes the following functions used to control the 
cursor position within the Logical Display Page: 


cuu 

Cursor Up 

CUD 

Cursor Down 

CUF 

Cursor Forward 

CUB 

Cursor Backward 

CUP 

Cursor Position 

HVP 

Horizontal/Vertical Position 

CPR 

Cursor Position Report 

DECXCPR 

Extended Cursor Report 

LNM 

Line Feed/New Line Mode 

CR 

Carriage Return 

LF 

Line Feed 

VT 

Vertical Tab 

FF 

Form Feed 

BS 

Backspace 

NEL 

Next Line 
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CURSOR UP CUU 


Levels: 1-4 

Purpose: Move the Active Position upward by n lines. 


Format: CSI Pn A default Pn: 1 

9/11 3/? 4/1 


Description: The CUU control moves the Active Position upward 

in the display. The distance moved is determined by the parameter 
value. A parameter value of zero or one moves the Active Position 
upward by one line. A parameter value of n moves the Active 
Position upward by n lines. 

Notes : 

1 . If the Active Position is at or below the Top Margin when 
the CUU control is executed, and an attempt is made to 
move the Active Position above the Top Margin, the 
control will be executed until the Active Position 
reaches the Top Margin. The Active Position will not 
move beyond the Top Margin. 

2 . If the Active Line is above the Top Margin when the CUU 
control is executed (due to absolute cursor positioning) 
and an attempt is made to move the Active Position 
outside of the addressable display, the control will be 
executed until the Active Position reaches the first line 
of the Page. The Active Position will not move beyond 
the first line of the Page. 

3. No scrolling will occur as a result of this control. 

4. If the line to which the Active Position is moved 
contains fewer columns than the Active Column, the Active 
Column is set to the end of that line. (This condition 
will only occur if the Active Line is a single-width 
line, and the line to which the Active Position is moved 
is a double-width or double-height line. The Active 
Column is not affected by the length of lines it moves 
over by a repeat move caused by a parameter value greater 
than one . ) 


State Affected: 


active_position 
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Algorithm: 

void cursor_up (parv) 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

short int n; 

if (parv[0] == 0) n = 1; 
else n = parv[0]; 

if (active_^osition . line >= top_margin) 

{ 

if ( (act ive_po sit ion . line - n) >= top_margin) 
active_position . line -= n; 
else 

active_position . line = top_margin; 

} 

else 

{ 

if ( (act ive_po sit ion . line - n) >= 1) 
active_position . line -= n; 
else 

active_position . line = 1; 

} 


/* new line may have a different length - adjust column */ 
if (active_position . column > end_of_line (active_position . line) ) 
active_position . column = end_of_line (active_^osition . line) ; 

} 


Known Deviations : None 
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CURSOR DOWN CUD 


Levels: 1-4 

Purpose: Move the Active Position downward by n lines. 


Format: CSI Pn B default Pn: 1 

9/11 3/? 4/2 


Description: The CUD control moves the Active Position downward 

in the display. The distance moved is determined by the parameter 
value. A parameter value of zero or one moves the Active Position 
downward by one line. A parameter value of n moves the Active 
Position downward by n lines. 

Notes : 

1. If the Active Position is at or above the Bottom Margin 
when the CUD control is executed, and an attempt is made 
to move the Active Position below the Bottom Margin, the 
control will be executed until the Active Position 
reaches the Bottom Margin. The Active Position will not 
move beyond the Bottom Margin. 

2. If the Active Position is below the Bottom Margin when 
the CUD control is executed (due to absolute cursor 
positioning) and an attempt is made to move the Active 
Position outside of the addressable display, the control 
will be executed until the Active Position reaches the 
bottom line of the Page. The Active Position will not 
move beyond the bottom line of the Page. 

3. No scrolling will occur as a result of this control. 

4. If the line to which the Active Position is moved 
contains fewer columns than the Active Column, the Active 
Column is set to the end of that line. (This condition 
will only occur if the Active Line is a single-width 
line, and the line to which the Active Position is moved 
is a double-width or double-height line. The Active 
Column is not affected by the length of lines it moves 
over by a repeat move caused by a parameter value greater 
than one . ) 


State Affected: 


active_position 
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Algorithm: 

void cursor_down (parv) 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

short int n; 

if (parv[0] == 0) n = 1; 
else n = parv[0]; 

if {active__position . line <= bottom_margin) 

{ 

if ( (active_j50sition. line + n) <= bottom_margin) 
active^osition. line += n; 
else 

active_position . line = bottom_margin; 

} 

else 

{ 

if ( (active_position . line + n) <= lines_per_page) 
active^osition . line += n; 
else 

active_position . line = lines_per_page; 

} 


/* new line may have a different length - adjust column */ 
if (active_position . column > end_of_line (active_position . line) ) 
active__position . column = end_of_line (act ive_posit ion . line) ; 

} 


Known Deviations: None 
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CURSOR FORWAEUD CUF 


Levels: 1-4 

Purpose: Move the Active Position forward by n columns. 


Format: CSI Pn C default Pn: 1 

9/11 3/? 4/3 


Description: The CUF control moves the Active Position forward 

in the display. The distance moved is determined by the parameter 
value. A parameter value of zero or one moves the Active Position 
forward by one column. A parameter value of n moves the Active 
Position forward by n columns. 

Notes : 

1. If the Active Position is at or inside the Right Margin 
when the CUF control is executed, and an attempt is made 
to move the Active Position beyond the Right Margin, the 
control will be executed until the Active Position 
reaches the Right Margin. The Active Position will not 
move beyond the Right Margin. 

2. If the Active Position is beyond the Right Margin when 
the CUF control is executed (due to absolute cursor 
positioning) and an attempt is made to move the Active 
Position outside of the addressable display, the control 
will be executed until the Active Position reaches the 
last column of the Active Line. The Active Position will 
not move beyond the last column of the Active Line. 

3. No scrolling will occur as a result of this control. 


State Affected: 


active_position 



VSRM - Character Cell Display EL-00070-05 Page 5-46 

Digital Internal Use Only - For Review Only 29-Jun-1990 


Algorithm: 

void cursor_f orward (parv) 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

short int n; 

if (parv[0] == 0) n = 1; 
else n = parv[0]/ 

if (active_position . column <= right_margin) 

{ 

if ( (active_position . column + n) <= right_margin) 
active_position . column += n; 
else 

active_position . column = right_margin; 

} 

else 

{ 

if ( (active_position . column + n) <= 

end_of_line (active_position . line) ) 
active_position . column += n; 
else 

active_position . column = end_of_line (active_position . line) ; 

} 


Known Deviations: None 
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CURSOR BACKWARD CUB 


Levels: 1-4 

Purpose: Move the Active Position backward by n columns. 


Format: CSI Pn D default Pn: 1 

9/11 3/? 4/4 


Description: The CUB control moves the Active Position backward 

in the display. The distance moved is determined by the parameter 
value. A parameter value of zero or one moves the Active Position 
backward by one one column. A parameter value of n moves the 
Active Position backward by n columns. 

Notes : 

1. If the Active Position is at or inside the Left Margin 
when the CUB control is executed, and an attempt is made 
to move the Active Position beyond the Left Margin, the 
control will be executed until the Active Position 
reaches the Left Margin. The Active Position will not 
move beyond the Left Margin. 

2. If the Active Position is beyond the Left Margin when the 
CUB control is executed (due to absolute cursor 
positioning) and an attempt is made to move the Active 
Position outside of the addressable display, the control 
will be executed until the Active Position reaches the 
first column of the Active Line. The Active Position 
will not move beyond the first column of the Active Line. 

3. No scrolling will occur as a result of this control. 


State Affected: 


active_position 
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Algorithm: 

void cursor_backward (parv) 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

short int n; 

if (parv[0] == 0) n = 1; 
else n = parv[0]/ 

if (active_position . column >= left_margin) 

{ 

if ( (act ive_posit ion . column - n) >= left_margin) 
active_position . column -= n; 
else 

active_position . column = left_margin; 

} 

else 

{ 

if ( (active_position . column - n) >= 1) 
active_j>osition . column -= n; 
else 

active_j30sition . column = 1; 

} 

} 


Known Deviations : None 
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CURSOR POSITION CUP 

Levels: 1-4 

Purpose: To position the Active Position at an absolute line and 

column address. 

Format: CSI PI ; Pc H default PI: 1 

9/11 3/? ; 3/? 4/8 default Pc: 1 


Description: The CUP control moves the Active Position to an 

absolute line and column address as specified by the parameter 
values. The first parameter specifies the new line address, and 
the second parameter specifies the new column address. If either 
parameter is omitted, or is explicitly set to zero (0) , that 
parameter value will default to one (1) . 

Notes : 

1. This control is affected by the setting of Origin Mode. 

If Origin Mode is reset, addressing is performed relative 
to the page origin (first column in the first line) . If 
Origin Mode is set, addressing is performed relative to 
the origin of the current scrolling region (the top and 
left margin) . 

2. If an attempt is made to move the Active Position outside 
of the addressable display area (the entire screen if 
Origin Mode is reset, or the scrolling region if Origin 
Mode is set) , the Active Position will be moved in the 
direction indicated to the boundary of the addressable 
area, but will not be moved beyond the boundary of the 
addressable area. 


State Affected: 


active_position 
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Algorithm: 

void cursor_position (parv) 

short int parv [MAX_NUM_PARAMETERS] / 

{ 

line_t y; 
column_t x; 
y = parv [ 0 ] ; 

X = parv [ 1 ] ; 
if (y == 0) y = 1; 
if (x == 0) X = 1; 
if (origin_mode == DISPLACED) 

{ 

if ( ( (top_margin-l) + y) <= bottom_margin ) 

active_position . line = (top_margin-l) + y; 
else 

active__position . line = bottom_margin; 

if ( ( (left_margin-l) + x) <= right_margin ) 

active_^osition . column = (left_margin-l) + x; 
else 

act ive_pos it i on . column = right_margin; 

} 

else 

{ 

if (y <= lines_jper_page) 
active_position . line = y; 
else 

active_position. line = lines_per_page; 

if (x <= end_of_line (active__position. line) ) 
active_position . column = x; 
else 

active_position . column = end_of_line (active_position . line) / 

} 

} 


Known Deviations: None 
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HORIZONTAL /VERT I CAL POSITION 


HVP 


1-4 

Move the Active Position to an absolute line and column 
(fallback implementation) 


CSI PI ; Pc f default PI: 1 

9/11 PI ; Pc 6/6 default Pc: 1 


Description: The HVP control moves the Active Position to an 

absolute line and column address as specified by the parameter 
values. The first parameter specifies the new line address, and 
the second parameter specifies the new column address. If either 
parameter is omitted, or is explicitly set to zero (0) , that 
parameter value will default to one (1) . 

Notes : 

1 . The HVP control is provided for interface compatibility 
with printing terminals. This implementation is not in 
conformance with existing standards . Conforming software 
will use the Cursor Position control to affect movement 
of the cursor, since the operation of Horizontal/Vertical 
Position may be redefined in future levels of the 
architecture . 

2. This control is affected by the setting of Origin Mode. 

If Origin Mode is reset, addressing is performed relative 
to the page origin (first column in the first line) . If 
Origin Mode is set, addressing is performed relative to 
the origin of the current scrolling region (the top and 
left margin) . 

3. If an attempt is made to move the Active Position outside 
of the addressable display area (the entire screen if 
Origin Mode is reset, or the scrolling region if Origin 
Mode is set) , the Active Position will be moved in the 
direction indicated to the boundary of the addressable 
area, but will not be moved beyond the boundary of the 
addressable area. 


Levels : 

Purpose : 
address . 

Format : 


State Affected: 


active_position 
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Algorithm: 

void horizontal_vertical_position (parv) 
short int parv [MAK_NUM_PARAMETERS] ; 

{ 

/* steal code from CUP */ 
cursor_position (parv) ; 

} 


Known Deviations : None 
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CURSOR POSITION REPORT CPR 

Levels: 1-4 

Purpose : Report the line and column address of the Active 

Position . 


Request Format : 

CSI 

6 

n 






9/11 

3/6 

6/14 





Report Format : 

CSI 

PI 

; Pc 

R 

default 

PI: 

1 


9/11 

3/? 

; 3/? 

5/2 

default 

Pc : 

1 

Description : 

The 

CPR control is 

transmitted by the terminal 


response to a specific Device Status Report (DSR) control. The 
parameter values indicate the Active Line and Active Column values 
at the time the DSR control is received by the terminal . 

Notes : 

1. This control is affected by the setting of Origin Mode. 

If Origin Mode is reset, addressing is performed relative 
to the page origin (first column in the first line) . If 
Origin Mode is set, addressing is performed relative to 
the origin of the current scrolling region (the Top and 
Left Margin) . 


State Affected: 


none 
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Algorithm: 

void cursor_j)osition_report 0 

{ 

line_t y; 
column_t x; 

if (origin_mode == DISPLACED) 

{ 

y = active_position. line - top_margin + 1; 

X = act ive_j50sit ion. column - left_margin + 1; 
} 

else 

{ 

y = act ive_posit ion . line; 

X = act ive_position . column; 

} 

send_char ( 0x9B, host_port) ; /* CSI */ 

send_int (y, host_port) ; 
send_char , host_port ) ; 
send_int (x, host_port) ; 
send_char {'R' , host_port ) ; 

} 


Known Deviations: None 
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EXTENDED CURSOR POSITION REPORT DECXCPR 


Levels : 3x (Windowing) , 4 

Purpose: Report the line, column, and page address of the Active 

Position . 


Request Format : 

CSI 

9/11 

7 

3/15 

6 

3/6 

n 

6/14 




Report Format : 

CSI 

9/11 

7 

3/15 

PI 

3/? 

3/11 

Pc 

3/? 

/ Pp 

3/11 3/? 

R 

5/2 


default PI, 

Pc, 

Pp: 1 





Description: The DECXCPR control is transmitted by the terminal 

in response to a specific Device Status Report (DSR) control. The 
parameter values indicate the Active Line, Column, and Page values 
at the time the DSR control is received by the terminal . The 
default condition with no parameters present, or parameters of 0, 
is equivalent to a cursor at the home position on the first Page. 

Notes: 

1. This control is affected by the setting of Origin Mode. 

If Origin Mode is reset, addressing is performed relative 
to the page origin (first column in the first line) . If 
Origin Mode is set, addressing is performed relative to 
the origin of the current scrolling region (the Top and 
Left Margin) . 


I State Affected: None 
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Algorithm: 

void x_cursor_position_report 0 

{ 

line_t y; 
column_t x; 

if (origin_mode == DISPLACED) 

{ 

y = active_^osition . line - top_margin + 1; 

X = active_position . column - left_margin + 1/ 

} 

else 

{ 

y = active_^osition . line; 

X = active^osition. column; 

} 

send_char (0x9B, host_port) ; /* CSI */ 

send_char , host_port ) ; 

send_int ( y , host^ort) ; 

send_char , host^ort ) ; 

send_int ( x, host_port) ; 

send_char , host_port) ; 

send_char (act ive_po sit ion .page, host_port) ; 
send_char ('R' , host^ort) ; 

} 

Known Deviations: None 
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SET/RESET NEW LINE MODE LNM 


Levels: 1-4 

Purpose: Change the state of New Line Mode between New Line Off 

(reset) and New Line On (set) . 


Set Format: CSI 20 h 

Reset Format: CSI 20 1 


Description: A conforming device shall provide a means of 

selecting whether a received Line Feed (LF ) , Vertical Tab (VT) , or 
Form Feed (FF) character shall be treated as a single instance of 
that character [reset state = no_new_line] , or that each of these 
characters is handled on receipt by additionally returning the 
Active Position to the first column of the display [set state = 
new_line] . It should be noted that setting of this mode also 
affects the processing of the Carriage Return (CR) key, which 
transmits a two-code sequence (CR LF) when New Line Mode is in the 
set state. 

(Note: This mode should not be used in the set state by 

conforming software.) 


State Affected: 
new line mode 


Algorithm: 

void set_new_line_mode 0 

{ 

new_line_mode = NEW_LINE_ON; 

} 


void reset_new_line_mode 0 

{ 

new_line_mode = NEW_LINE_OFF; 

} 


Known Deviations : None 
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CAFLRIAGE RETURN CR 


Levels: 1-4 

Purpose: Move the Active Position to the Left Margin. 


Format : CR 

0/13 


I Description: The CR control moves the Active Position to the Left 
I Margin. If the Active Position is before the left margin, or 
I outside the top and bottom margins, the cursor moves to the first 
column of the Active Line. 


State Affected: 
active_position 


Algorithm: 

void_carriage_return () 

{ 

if ( (act ive_jposit ion . column >= left_margin) && 
(active_position . line >= top_margin) && 
(active__position . line <= bottom_margin) ) 
active_pos it ion . column = left_margin; 
else 

active_position . column =1; 

} 


Known Deviations: None 
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LINE FEED LF 


Levels: 1-4 

Purpose: Move the Active Position downward one line, scrolling if 

necessary . 


Format : LF 

0/10 


Description: The LF control moves the Active Position downward 

in the display by one line. If the Active Position is already at 
the Bottom Margin the display will scroll upward by one line. 

Notes : 

1 . If the Active Position is above the Bottom Margin when 
this control is executed, the Active Position will not 
move beyond the Bottom Margin. 

2. If the Active Position is below the Bottom Margin when 
this control is executed (as the result of absolute 
cursor positioning) it will still move downward by one 
line and no scrolling will occur. In this case, the 
Active Position will not move beyond the bottom line of 
the display. 

3. If the line to which the Active Position is moved 
contains fewer columns than the Active Column, the Active 
Column is set to the end of that line . 

4. This control is affected by the setting of New Line Mode. 
If this mode is reset, no change will occur in the Active 
Column unless the line below the Active Line is shorter 
than the Active Line (see note 2) . If the mode is set, 
the control causes the Active Column to be set to the 
first column of the line into which the Active Position 
is moved. Conforming software is recommended to use the 
two character sequence (CR LF) rather than New Line mode 
for widest compatibility. 

5. Note that the fundamental differences between this 
control and the CUD control are the effect of New Line 
Mode and the occurrence of scrolling on reaching the 
Bottom Margin. 

6. The LF control is identical in function to the IND 
(Index) control when New Line Mode is in the reset (No 
New Line) state. 
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State Affected: 

di sp 1 ay [ MAX_NUM_L INE S ] [ MAX_NUM_COLUMNS ] 
active_position 


Algorithm: 

void line_feed() 

{ 

if (new_line_mode == NEW_LINE_ON) carriage_return () ; 
if (active_position . line == bottom_margin) 
scroll_up (top_margin, 1); 
else 

if (active_position . line < lines_per_^age) 
active^osition . line += 1; 

/* new line may have different length - adjust column */ 
if (active_jposition . column > end_of_line (active_position . line) ) 
active_position . column = end_of_line (active_position . line) ; 

} 


Known Deviations: None 
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VERTICAL TAB VT 


Levels: 1-4 

Purpose: Move the Active Position downward one line, scrolling if 

necessary. (fallback implementation) 


Format : VT 

0/11 


Description: The VT control moves the Active Position downward 

in the display by one line. If the Active Position is already at 
the Bottom Margin the display will scroll upward by one line. 

Notes : 

1 . The implementation of the VT control is a fallback 
mechanism for display terminals which is intended to 
provide compatibility with printers which correctly 
implement this function. 

2. This control is identical in function to the Line Feed 
(LF) control. It is provided for software compatibility 
with printer output. It should be noted, however, that 
printers will implement this function differently. It is 
therefore recommended that software use the Line Feed 
control to perform this function instead of Vertical Tab. 


State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS ] 
active_j>osition 

Algorithm: 

void vertical_tab 0 

{ 

line_feed(); /* fallback implementation */ 

} 


Known Deviations : None 
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FORM FEED FF 

Levels: 1-4 

Purpose: Move the Active Position downward one line, scrolling if 

necessary. (fallback implementation) 

Format : FF 

0/12 


Description: The FF control moves the Active Position downward 

in the display by one line. If the Active Position is already at 
the Bottom Margin the display will scroll upward by one line. 

Notes : 

1 . The implementation of the FF control is a fallback 
mechanism for display terminals which is intended to 
provide compatibility with printers which correctly 
implement this function. 

2 . This control is identical in function to the Line Feed 
(LF) control. It is provided for software compatibility 
with printer output. It should be noted, however, that 
printers will implement this function differently. It is 
therefore recommended that software use the Line Feed 
control to perform this function instead of Form Feed. 


State Affected: 

di sp 1 ay [ MAX_NUM_L INE S ] [ MAX_NUM_COLUMNS ] 
active_position 


Algorithm: 

void form_feed() 

{ 

line_feed(); /* fallback implementation */ 

} 


Known Deviations: None 
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BACK SPACE BS 


Levels: 1-4 

Purpose: Move the Active Position one column to the left. 

Format : BS 

0/8 


Description: The BS control moves the Active Position backward 

in the display by one column. 

Notes : 

1 . If the Active Position is at or inside the Left Margin 
and within the Scroll Area, it will not move beyond the 
Left Margin. 

2. If the Active Position is already before the Left Margin, 
the Active Position will move left one column unless it 
is at the first column of the Active Line. The Active 
Position will not move beyond the beginning of the Active 
Line . 

3. The BS control is not affected in any way by the setting 
of Auto Wrap Mode. Under no circumstances does the 
Active Position advance to the previous line on reaching 
the beginning of the Active Line. 


State Affected: 

active_position 


Algorithm: 

void back_space() 

{ 

if (active_position . column > left_margin) 
active_position . column -= 1/ 
else 
{ 

if ( ( (active_position . column != left_margin) || 

(active_position. line < top_margin) | 1 
(active_position . line > bottom_margin) ) && 
( act ive_posit ion . column >1) ) 

active_j)Osition . column -= 1; 

} 

} 


Known Deviations : None 
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NEXT LINE NEL 

Levels: 1-4 

I Purpose: Move the Active Position to the Left Margin of the next 
I line, scrolling if necessary. 


Format : NEL 

8/5 (ESC E) 


Description: The NEL control moves the Active Position to the 

I Left Margin of the next line. If the Active Line is equal to the 
Bottom Margin, the Active Line is not incremented, but instead the 
I display scrolls upward by one line. If the Active Position is 
I before the left margin, or outside the top and bottom margins, it 
I will move to the first column of the next line, but not beyond the 
I last line on the page. 

Notes : 

1 . This control is identical to sending Line Feed (LF) with 
Line Feed New Line Mode set. It is also identical to 
sending Carriage Return (CR) followed by Line Feed (LF) . 
Software is recommended to always use the combination of 
Carriage Return followed by Line Feed (CR LF) to achieve 
this effect for widest compatibility. 


State Affected: 

di sp 1 ay [ MAX_NUM_L INE S ] [ MAX_NUM_COLUMNS ] 
active_position 

Algorithm: 

void next_line() 

{ 

carriage_return () ; 
line_feed()/ 

} 


Known Deviations : None 
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5.4.5 Horizontal Tabulation 

A conforming device shall provide the ability to set a horizontal 
tabulation stop at each display column. These boolean indicators 
must be capable of being set or reset in any possible combination. 
It should be noted that only tab stops are stored by the device, 
not tab characters . 

Setting of horizontal tab stops may be performed both as a remote 
and local function, and therefore the settings at any point in 
time is indeterminate. However, when no local provision is made 
for the setting and/or storage of user defined tabulation stops, 
the following default states shall be used by conforming devices. 
These settings should also apply to the factory default settings 
for a conforming device. 

tab stops = 

columns 9, 17, 25, 33, 41, 49, 57, 65, 73, 81, 89, 97, 105,113, 121,129 
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TABULATION CLEAR TBC 


Levels: 1-4 

Purpose: Clear Horizontal Tab Stops. 


Format: CSI Ps g default Ps : 0 

9/11 3/? 6/7 


Description: The TBC control provides a means of clearing or 

removing previously set Horizontal Tab Stops. The range of 
positions affected by this control is determined by the parameter 
value. An omitted parameter or a parameter value of zero (0) 
cause the control to clear only a tabulation stop set at the 
Active Column. A parameter value of three (3) causes the control 
to clear all Horizontal Tab Stops in the display. 

State Affected: 

horizontal_tab_stops [MAX_NUM_COLUMNS ] 

Algorithm: 

void tabulation_clear (pare, parv) 
short int pare; 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

column_t x; 
short int n; 

if (pare == 0) pare =1; 
for (n=0; n<parc; n++) 

{ 

if (parv[n] == 0) 

horizontal_tab_stops [act ive_position . column] = FALSE; 
else if (parv[n] == 3) 

for (x=l; x<= columns_per__page; x++) 
horizontal_tab_stops [x] = FALSE; 

} 

} 


Known Deviations : None 
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HORIZONTAL TAB HT 


Levels: 1-4 

Purpose: Advance the Active Position to the next Horizontal Tab 

Stop . 


Format : HT 

0/9 


Description: The HT control moves the Active Position forward 

in the display to the next Horizontal Tab Stop in the Active Line. 

Notes : 

1 . If no tabulation stop is reached before the Right Margin 
of the Active Line (within the Scroll Area ) , the Active 
Position will be set to the Right Margin of the Active 
Line. If the Active Column is beyond the Right Margin or 
the Active Line is outside the Scroll Area (due to 
absolute cursor positioning) , the Active Position will 
move to the next tab stop;^ or last column of the Active 
Line, whichever comes first. 


State Affected: 


active_position 
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Algorithm: 

void horizontal_tab ( ) 

{ 

boolean_t outside; 

if ( (active__position . line > top_margin) && 

(active__position . line < bottom_margin) ) 
outside = FALSE; 
else 

outside = TRUE ; 

if ( (active_position . column < 

end_of_line (active_position . line) ) && 

( (active_position . column != right_margin) || (outside==TRUE) ) 

) 

active_position . column += 1; 

for (; ( (active_position . column < 

end_of_line (active j)OS it ion . line) ) && 

(horizontal_tab_stops [active_position . column] != TRUE) && 
( (active_position . column != right_margin) || 
(outside==TRUE) ) ) ; 

active j>osition . column += 1); 

} 


Known Deviations : None 
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HORIZONTAL TABULATION SET HTS 

Levels: 1-4 

Purpose: Set a Horizontal Tab Stop at the Active Column. 

Format : HTS 

8/8 (ESC H) 


Description: The HTS control causes a Horizontal Tab Stop to be 

set at the column position indicated by the value of the Active 
Column at the time this control is received. 

Notes : 

1. None of the other Horizontal Tab Stop settings are 
affected by execution of this control. 


State Affected: 

horizontal_tab_st ops [MAX_NUM_COLUMNS ] 


Algorithm: 

void horizontal_tabulation_set () 

{ 

horizontal_tab_stops [active_position . column] = TRUE; 

} 


Known Deviations : None 
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5.4.6 Page Size And Arrangement 

Level 1 and Level 2 conforming devices support a single Logical 
Display Page of 24 lines by 80 columns, extendable to 24 lines by 
132 columns when the "132 Column Mode" extension is present 
(DECCOLM) . 

Level 4 devices, and Level 3 devices with the "Windowing 
Extension" shall support commands to change the Logical Display 
Page Size (DECSLPP and DECSCPP) . The actual Page Sizes supported 
shall be clearly specified in the product documentation, and means 
shall be provided for software to interrogate the size of the 
Logical Display Page (see "Terminal State Interrogation") . The 
Page Size and number of pages in the Logical Display may also be 
configurable by the user under local control. 
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SET/RESET COLUMN MODE DECCOLM 


Levels: IX, 2X, 3X, 4X 

Purpose: Change the state of Column Mode between Eighty (reset) 

and One Thirty Two (set) . 


Set Format: CSI ? 3 h 

Reset Format: CSI ? 3 1 


Description: A conforming device may provide as an extension the 

capability of selecting 80-column [reset state = eighty] or 
132-column [set state = one_thirty_two] display format. 

Selecting Eighty or One_Thirty_Two Column Mode causes the display 
data to be cleared, the scrolling region to be eliminated, and the 
Active Position to be set to the display origin (1,1), even if the 
terminal was already in the selected state . 

Notes : 

1. The font used to display Page Memory may change when the 
number of columns on the page changes to better match the 
screen. Control of when the font changes may be provided 
as a Set-Up option. 

2. If the Host Writable Status Line is enabled, receipt of 
this sequence will clear both the main display and the 
Host Writable Status Line. 


State Affected: 

di sp 1 ay [ MAX_NUM_L INE S ] [ MAX_NUM_COLUMNS ] 
1 ine_r endi t i on [ MAX_NUM_L INE S ] 
active_position 
top_margin 
bottom_margin 
column_mode 
I left_margin 

1 right_margin 

1 columns_per_page 

I left_right_margins_mode 
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Algorithm: 

void set_column_mode 0 

{ 

line_t y; 
column_t x; 

column_mode = ONE_THIRTY_TWO; 

I columns_per_page = 132; 

for (y=l; y<MAX_NUM_LINES; y++) 

{ 

for (x=l; x<MAX_NUM_COLUMNS; x++) 

display [y] [x] .code = EMPTY_CHARACTER; 
line_rendition[y] = SINGLE_WIDTH/ 

} 

act ive^osit ion . line = 1; 
active_position . column = 1; 
top_margin = 1 ; 

I bottom_margin = lines_per_page; 

I left_margin = 1; 

I right_margin = columns_per_page; 

I left_right_margins_mode = SETABLE; 

} 


void reset_column_mode ( ) 

{ 

line_t y; 
column_t x; 
column_mode = EIGHTY; 

I columns_per_page = 80; 

for (y=l; y<MAX_NUM_LINES; y++) 

{ 

for (x=l; x<MAX_NUM_COLUMNS; x++) 

display [y] [x] .code = EMPTY_CHARACTER; 
line_rendition [y] = SINGLE_WIDTH; 

} 

active_position . line = 1; 
active_position . column = 1; 
top_margin = 1 ; 

I bottom_margin = lines_per_page; 

1 left_margin = 1; 

I right_margin = columns_per__page; 

I left_right_margins_mode = SETABLE; 

} 


Known Deviations: None 
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SET COLUMNS PER PAGE DECSCPP 


Levels: 3X (Windowing), 4 

Purpose: Set the number of columns per page in the Logical 

Display. 


Format: CSI Pn $ | 

9/11 3/? 2/4 7/12 


Description: This sequence sets the number of columns in the 

display page according to the numeric parameter. If the parameter 
is omitted or zero, the page width is defaulted to 80. If the 
number of columns specified is not one of the values supported by 
the implementation, the next higher supported number of columns 
per page is assumed. If the number of columns specified exceeds 
the maximum number supported, the maximum number supported will be 
used. 

DECSCPP does not cause the Active Position to move. However if 
the active position is beyond the width of the new page when the 
command is executed, the active position will be moved to the 
right edge of the page. DECSCPP does not cause the Right Margin 
to move. However if the right margin is beyond the width of the 
new page when the command is executed, the right margin will be 
moved to the right edge of the page. When changing from a 132 
column to a 80 column page, the information in columns 1-80 is 
preserved. The information in columns 81-132 is cleared. When 
changing from an 80 column page to a 132 column page, the 
information in columns 1-80 is preserved. 

Notes on DECSCPP : 

1. The font used to display Page Memory may change when the 
number of columns on the page changes to better match the 
screen. Control of when the font changes may be provided 
as a Set-Up option. 

2 . The number of columns per page can also be changed 
through Column Mode (DECCOLM) . The affect of DECSCPP is 
similar to DECCOLM except that DECSCPP does not clear 
page memory. 

3. DECSCPP does not change the setting of DECLRMM. 


Implementation Guideline 

The VT420 can configure its off-screen memory to 
pages of either 80 or 132 columns wide. When the 
page width changes, the corresponding 80 or 132 
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column font is automatically selected. 


State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 

active_position 

right_margin 

columns_per_page 


Algorithm: 

void set_columns_per j)age (parv) 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

line_t y; 
column_t x; 

if ( (conf ormance_level == LEVEL_4) | | 

(level_3_extensions [WINDOWING] ==TRUE) ) 

{ 

if (parv[0] <= 80) 

/* set columns per page to 80 */ 

{ 

for (y=l/ y<MAX_NUM_LINES/ y++) 

{ 

for (x=81; x<MAX_NUM_COLUMNS ; x++) 

display [y] [x] .code = EMPTY_CHARACTER; 

} 

if (activej>osition . column > 80) active_jposition . column = 80; 
if (right_margin > 80) right_margin = 80; 

/* optional font change */ 

if (columns__per_page > 80) select_normal_font () ; 
columns_per_page = 80; 

} 

else 

/* set columns per page to 132 */ 

/* optional font change */ 

if {columns_per_page <= 80) select_condensed_font () ; 
columns_per_page = 132; 

} 

} 


Known Deviations: None 
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SET LINES PER PAGE DECSLPP 


Levels : 3X (Windowing) , 4 

Purpose: Set the number of lines per page in the Logical Display. 


Format: CSI Pn t 

9/11 3/? 7/4 


Description: This sequence sets the number of display lines per 

page according to the numeric parameter. If the parameter is 
omitted or zero, the page length is defaulted to 24. If the 
number of lines specified is not one of the values supported by 
the implementation, the next higher supported number of lines per 
page is assumed. If the number of lines specified exceeds the 
maximum number supported, the maximum number supported will be 
used. 

DECSLPP does not cause Page Memory to be cleared, however, 
information contained in a larger page may appear in successive 
smaller pages, if the new height of the pages selected by the 
DECSLPP is too small to hold the information. 

DECSLPP does not cause the scrolling regions to be reset, or the 
Active Position to move, except under the following circumstances: 
The scrolling margins may be reset to the extremes of the new Page 
Configuration if the current scrolling margin exceeds the physical 
limits of the new Page height; and, the Active Position will move 
to the same column in the maximum available line, if the Active 
Position exceeds the available number of lines in the new page 
size . 

Conformance to Level 4 requires support for 3 pages of 24 lines. 

Implementation Guideline 

The VT420 can configure its off-screen memory to 
either 3 pages of 24 lines, 2 pages of 25 lines, 2 
pages of 36 lines, or 1 page of 72 lines in 
double-session mode, or 6 pages of 24 lines, 5 
pages of 25 lines, 4 pages of 36 lines, 2 pages of 
72 lines, or 1 page of 144 lines in single-session 
mode . 


State Affected; 

lines j>er_page 

number_of_pages 

active_position 
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top_margin 

bottom_inargin 


Algorithm: 

void set_lines_per_page (parv) 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

if ( (conf ormance_level == LEVEL_4) | | 

(level_3_extensions [WINDOWING] ==TRUE) ) 

{ 

if (parv[0] <= 24) 

{ 

lines_per_page =24; 
number_of_pages = 3; 

} 

else if (parv[0] == 25) 

{ 

lines_per_j)age = 25; 
number_of_pages = 2; 

} 

else if (parv[0] <= 36) 

{ 

lines_per_page = 36; 
number_of_^ages = 2; 

} 

else 

{ 

lines_per_j3age = 72; 
number_of_pages =1; 

} 

if (active_position . line > lines_per_page) 
active_position . line = lines_per_page; 
if (active_position.page > number_of_pages) 
active_position.page = number_of_jpages; 
if (top_margin > lines_per__page) 
top_margin = 1 ; 

if (bottom_margin > lines_per_^age) 
bottom_margin = lines_per_page; 

} 

} 


Known Deviations : None 



VSRM - Character Cell Display EL-00070-05 Page 5-77 

Digital Internal Use Only - For Review Only 29-Jun-1990 


5.4.7 Page Movement 

NEXT PAGE NP 


Levels: 3x (Windowing), 4 

Purpose : To move the Active Position ahead one or more pages in 

the Logical Display. 


Format: CSI Pn U 

9/11 3/? 5/5 


Description: This sequence causes the Active Position to move 

ahead a number of pages, specified by the parameter. If the 
parameter value is zero (the default) or one, the active position 
moves ahead 1 page. If the sequence calls for a page beyond the 
last page of display memory, the highest numbered page is used. 

NP moves the Active Position to the home position in the new page 
obeying Origin Mode . 

Whether or not the new page is displayed depends upon the setting 
of DECPCCM. 


State Affected: 


active_position 
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Algorithm: 

void next_page (parv) 

short int parv [MAX_NUM_PARAMETERS ] ; 

{ 

if ( (conf ormance_level == LEVEL_4) | | 

(level_3_extensions [WINDOWING] ==TRUE) ) 

{ 

if (parv[0] == 0) parv[0] = 1; 

if ( (active_position .page + parv[0]) <= nuinber_of_pages) 
act ive_posit ion. page += parv[0]; 
else 

active_position .page = number_of_pages; 
if (origin_mode = DISPLACED) 

{ 

active_position . line = top_margin; 
active_position . column = left_margin; 

} 

else 

{ 

active_position . line = 1/ 
active_position . column =1; 

} 

} 

} 


Known Deviations: None 
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PRECEDING PAGE PP 


Levels: 3x (Windowing), 4 

Purpose: To move the Active Position back one or more pages in 

the Logical Display. 


Format: CSI Pn V 

9/11 3/? 5/6 


Description: This sequence causes the active position to move 

back a number of pages, specified by the parameter. If the 
parameter value is zero (the default) or one, the active position 
moves back 1 page. If the sequence calls for a page before the 
first page of display memory, the first page is used. PP moves 
the active position to the home position in the new page obeying 
Origin Mode . 

Whether or not the new page is displayed depends upon the setting 
of DECPCCM. 


State Affected: 


active_position 
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Algorithm: 

void preceding_page (parv) 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

if ( (conformance_level == LEVEL_4) | | 

(level_3_extensions [WINDOWING] ==TRUE) ) 

{ 

if {parv[0] == 0) parv[0] = 1; 
if (active_position.page > parv[0]) 
act ive_j>o sit ion .page -= parv[0]; 
else 

act ive__po sit ion .page = 1/ 
if (origin_mode = DISPLACED) 

{ 

active_position . line = top_margin; 
active_position . column = left_margin/ 

} 

else 

{ 

act i ve_po sition.line = 1; 
active_position . column = 1; 

} 

} 

} 


Known Deviations : None 
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PAGE POSITION ABSOLUTE PPA 


Levels: 3x (Windowing), 4 

Purpose: To move the Active Position to the specified page in the 

Logical Display. 


Format: CSI Pn SP P (default Pn: 1) 

9/11 3/? 2/0 5/0 


Description: This sequence moves the Active Position to the 

corresponding line and column on the n-th page. If there are 
fewer than n pages in display memory, the highest numbered page is 
used. 

Whether or not the new page is displayed depends upon the setting 
of DECPCCM. 


State Affected: 

active_position 


Algorithm: 

void page_position_absolute (parv) 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

if ( (conf ormance_level == LEVEL_4) | | 

(level_3_extensions [WINDOWING] ==TRUE) ) 

{ 

if (parv[0] == 0) parv[0] = 1; 
if (parv[0] <= number_of_pages) 
active_position .page = parv[0]; 
else 

act ive_position .page = number_of_pages/ 

} 


Known Deviations : None 
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PAGE POSITION RELATIVE PPR 


Levels: 3x (Windowing), 4 

Purpose: To move the Active Position forward to the n-th 

succeding page in the Logical Display. 


Format: CSI Pn SP Q (default Pn: 1) 

9/11 3/? 2/0 5/1 


Description: This sequence moves the active position to the 

corresponding line and column of the n-th succeding page. If the 
sequence calls for a page beyond the last page of display memory, 
the highest numbered page is used. 

Whether or not the new page is displayed depends upon the setting 
of DECPCCM. 


State Affected: 

active_position 


Algorithm: 

void page_position_relative (parv) 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

if ( (conformance_level == LEVEL_4) | | 

(level_3_extensions [WINDOWING] ==TRUE) ) 

{ 

if (parv[0] == 0) parv[0] =1; 

if ( (active_position.page + parv[0]) <= nuinber_of_jpages) 
active_position.page += parv[0]; 
else 

act ive_po sit ion. page = number_of_pages; 

} 

} 


Known Deviations : None 
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PAGE POSITION BACKWARD PPB 


Levels: 3x (Windowing), 4 

Purpose: To move the Active Position back to the n-th preceding 

page in the Logical Display. 


Format: CSI Pn SP R (default Pn: 1) 

9/11 3/? 2/0 5/2 


Description: This sequence moves the active position to the 

corresponding line and column on the n-th preceding page. If the 
sequence calls for a page before the first page of display memory, 
the first page is used. 

Whether or not the new page is displayed depends upon the setting 
of DECPCCM. 


State Affected: 

active_position 


Algorithm: 

void page_position_backward (parv) 

short int parv [MAX;_NUM_PARAMETERS] ; 

{ 

if ( (conf ormance_level == LEVEL_4) | | 

(level_3_extensions [WINDOWING] ==TRUE) ) 

{ 

if (parv[0] == 0) parv[0] = 1; 
if (active_position .page > parv[0]) 
active_position.page -= parv[0]; 
else 

act ive_position .page = 1; 

} 


Known Deviations: None 
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5.5 WINDOWING EXTENSION 


The Windowing Extension supports Logical Display Page sizes that 
are larger or smaller than the physical display. A rectangular 
area of the screen (physical display) that displays information 
from a Logical Display Page is called a window. 


Conforming devices may provide local window management features 
for creating and manipulating more than one window on the physical 
display at a time (guideline) . 

The following functions described in this subsection are used to 
control how an area of the Logical Display is mapped to a window 
on the physical display. 


DECHCCM 

DECVCCM 

DECPCCM 

DECRQDE 

DECSNLS 

SU 

SD 


Horizontal Cursor Coupling Mode 
Vertical Cursor Coupling Mode 
Page Cursor Coupling Mode 
Request Displayed Extent 

Select Number of Lines per Screen (documented 
exception) 

Pan Down 
Pan Up 


The Windowing Extension also supports two commands for changing 
the the size of the Logical Display Page (DECSLPP and DECSCPP, see 
"Page Size and Arrangement") . Finally, if more than one page of 
display memory is supported, the Windowing Extension includes 
commands to move the active position among the pages (NP, PP, PPA, 
PPR, and PPB, see "Page Movement") . 

The Windowing Extension may be provided at Level 1 or higher of 
the Character Cell Display service class, and is indicated by the 
extension parameter 18 in the Device Attributes (DA) response. 
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SET/RESET HORIZONTAL CURSOR COUPLING MODE DECHCCM 


Levels: 3x, 4x (Windowing) 

Purpose: Change the state of Horizontal Cursor Coupling Mode 

between coupled (set state, page moves horizontally in the window 
to keep cursor visible) , and uncoupled (reset state) . 


To set: CSI ? 60 h (coupled) 

To reset: CSI ? 60 1 (uncoupled - default) 


Description: DECHCCM is a parameter to the Set Mode and Reset 

Mode commands. In the reset (uncoupled) state, when the active 
position within a page goes left or right of the borders of the 
displayable area (window) , the page does not move with respect to 
the window to keep the cursor visible. The cursor is not shown in 
this case. The cursor is said to be "uncoupled" from the display. 
In the set state, when the active position within a page goes left 
or right of the borders of the displayable area (window) , the page 
is moved the minimum amount to an 8 column boundary in the 
horizontal direction to keep the cursor position visible. The 
cursor is said to be "coupled" to the display. 

Notes on DECHCCM: 

1. Horizontal Cursor Coupling does not need to be provided 
when there is no way for a Logical Display Page to have 
more columns than can be shown in the narrowest window. 

2 . Horizontal Cursor Coupling may be enabled or disabled 
under local control in Set-Up. 

3. If a Set Mode command setting DECHCCM is received while 
the Active Column is not visible on the display, the page 
is moved to include the Active Column. 

4. Whether or not the cursor is actually visible may also 
depend on the state of Vertical and Page Cursor Coupling 
(DECVCCM and DECPCCM) . 

5. Existing implementations move the page the minimum amount 
to make the cursor visible. Experience suggests moving 
the minimum amount to an 8 column boundary would make the 
display easier to follow for the user (less frequent 
movement) . 


VSRM - Character Cell Display EL-00070-05 Page 5-86 

Digital Internal Use Only - For Review Only 29-Jun-1990 


SET/RESET VERTICAL CURSOR COUPLING MODE DECVCCM 


Levels; 3x, 4x (Windowing) 

Purpose; Change the state of Vertical Cursor Coupling Mode 
between coupled (set state, page moves vertically in window to 
keep cursor visible) , and uncoupled (reset state) . 


To set; CSI ? 61 h (coupled - default) 

To reset; CSI ? 61 1 (uncoupled) 


Description; DECVCCM is a parameter to the Set Mode and Reset 
Mode commands. In the reset state, when the active position 
within a page goes above or below the borders of the displayable 
area (window) , the page does not move with respect to the window 
to keep the cursor visible. The cursor is not shown in this case. 
The cursor is said to be "uncoupled" from the display. In the set 
state, when the active position within a page goes above or below 
the borders of the displayable area (window) , the page is moved 
the minimum amount in the vertical direction to keep the cursor 
position visible. The cursor is said to be "coupled" to the 
display . 

Notes on DECVCCM; 

1. Vertical Cursor Coupling may be enabled or disabled under 
local control in Set-Up. 

2. If a Set Mode command setting DECVCCM is received while 
the Active Line is not visible on the display, the page 
is moved to include the Active Line. 

3. Whether or not the cursor is actually visible may also 
depend on the state of Horizontal and Page Cursor 
Coupling (DECHCCM and DECPCCM) . 
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SET/RESET PAGE CURSOR COUPLING MODE DECPCCM 


Levels: 3x, 4x (Windowing) 

Purpose: Change the state of Page Cursor Coupling Mode between 

coupled (set state, switch page in window to keep cursor visible) , 
and uncoupled (reset state) . 


To set: CSI ? 64 h (coupled - default) 

To reset: CSI ? 64 1 (uncoupled) 


Description: DECPCCM is a parameter to the Set Mode and Reset 

Mode commands. In the reset state, when the active position moves 
to a new page in a multiple page configuration, the display is not 
refreshed to keep the cursor visible. The cursor is not shown in 
this case. The cursor is said to be "uncoupled" from the display. 
In the set state, when the active position moves to a new page, 
the destination page is refreshed on the Main Display to keep the 
cursor position visible. The cursor is said to be "coupled" to 
the display. 

Notes on DECPCCM: 

1. Page Cursor Coupling may be enabled or disabled under 
local control in Set-Up. 

2. If a Set Mode command setting DECPCCM is received when 
the Active Page containing the cursor is not visible on 
the display, the Active Page is refreshed on the Main 
Display . 
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REQUEST/REPORT DISPLAYED EXTENT DECRQDE/DECRPDE 


Levels: 3x, 4x (Windowing) 

Purpose: To determine the area of page memory currently visible 

in the display window. 


Request 

form: 

CSI 

If 

V 





9/11 

2/2 

7/6 



Report 

form: 

CSI 

Ph ; 

Pw ; 

Pml ; Pmt ; Pmp 

" w 



9/11 

Ph ; 

Pw ; 

Pml ; Pmt ; Pmp 

2/2 7/7 

Description : 

The DECRQDE 

sequence, which takes 

no parameters. 


causes the device to respond with a DECRPDE control function 
describing the area of Page Memory being displayed on the physical 
screen . 

The DECRPDE parameters provide the following information: 

Ph - The number of lines (height) of Page Memory being 

displayed in the window. This does not include any 
status line (see "Status Display") . If no lines from 
the active session are visible, 0 is returned (see 
"Session Management") . 

Pw - The number of columns (width) of Page Memory being 
displayed in the window. Pw is not necessarily 0 
when Ph is 0 . Ph should be used to determine whether 
any lines are visible. 

Pml - The column in Page Memory that is displayed in the 
leftmost column of the window. 

Pmt - The line in Page Memory that is displayed in the 
topmost line of the window. 

Pmp - The page of Page Memory that is being displayed 
through the window. 


VSRM - Character Cell Display EL-00070-05 Page 5-89 

Digital Internal Use Only - For Review Only 29-Jun-1990 


SELECT NUMBER OF LINES PER SCREEN DECSNLS 

Levels: Documented Exception (Windowing) 

Purpose: To select a font size and corresponding maximum number 

of lines that will fit on the physical display. 


Format: CSI Pn * | 

9/11 Pn 2/10 7/12 


Description: DECSNLS selects the maximum number of lines which 

can be displayed on the screen by choosing a corresponding font 
size . 

Pn is a numeric parameter between 1 and 255 which indicates the 
number of lines which can be displayed on the screen at one time. 
If a value not directly supported by the terminal is selected, the 
next larger size supported will be used. If Pn is greater than 
the largest number of lines available, the largest number 
supported will be used. The number of lines per screen that can 
be supported will be clearly specified in the product 
documentation . 

Although DECSNLS selects a font height which determines the 
maximum number of lines which can be displayed, the actual number 
of data lines displayed can be limited by other factors including 
the Page Size, whether there is a Status Display, and local window 
management functions if any. Applications can determine the 
actual number of lines displayed using the Request Display Extent 
(DECRQDE) control sequence. 

Notes on DECSNLS : 

1 . The terminal will not display more lines than are 
contained on a single page within a single window. 

2. A Status Display, if enabled, may occupy lines that would 
otherwise be available for showing data from the Logical 
Display Page. 

3. Unused lines will be left blank at the bottom of the 
window, or screen. 

DECSNLS is a "User Preference Feature" intended for 
terminal management use. It should not be modified by 
application software except in response to a user 
request . The terminal may provide a means to lock 
DECSNLS under local control (User Features Lock in 
Set-Up) to prevent host modification. 


4 . 
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5. It is suggested that software specify Pn to match the 
Logical Display page sizes supported. This will provide 
the best compatibility between implementations. 

6 . The terminal may provide a local mechanism to change 
DECSNLS automatically when the Page Size is changed 
("auto resize window") . 


Implementation Guideline 

The VT420 supports three different font heights 
which allow either 24, 39 or 49 data lines to be 
displayed on the screen, plus a status line. 
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PAN DOWN (SCROLL UP) SU 

Levels: 3x, 4x (Windowing) 

Purpose: To cause the current page to move up with respect to the 

window making another line visible at the bottom. 


Format: CSI Pn S (default Pn: 1) 

9/11 Pn 5/3 


Description: Causes the entire visible contents of the current 

page to move up one or more lines on the physical display 
according to the parameter. The line at the top border of the 
window is no longer seen, and a new line appears at bottom border 
of the window for each position moved. A numeric parameter of 
zero or one causes the page to move one line . 

The window cannot be moved beyond the boundaries of the page . 

This control affects what is visible on the physical display only. 
No movement of data within the Logical Display occurs . The Active 
Position does not change. 


VSRM - Character Cell Display EL-00070-05 Page 5-92 

Digital Internal Use Only - For Review Only 29-Jun-1990 


PAN UP (SCROLL DOWN) SD 

Levels: 3x, 4x (Windowing) 

Purpose : To cause the current page to move down with respect to 

the window making another line visible at the top. 


Format: CSI Pn T (default Pn: 1) 

9/11 Pn 5/4 


Description: Causes the entire visible contents of the current 

page to move down one or more lines on the physical display 
according to the parameter. The line at the bottom border of the 
window is no longer seen, and a new line appears at top border of 
the window for each position moved. A numeric parameter of zero 
or one causes the page to move one line . 

The window cannot be moved beyond the boundaries of the page. 

This control affects what is visible on the physical display only. 
No movement of data within the Logical Display occurs. The Active 
Position does not change. 
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5.6 VISUAL RENDITIONS 

This subsection describes functions used to control the visual 
appearance of characters on the display. Attributes to be 
controlled include screen background (light or dark) , character 
size (double wide and double size line attributes) , character 
emphasis (bold, blink, underline, reverse) , and character color 
when the Color Text Extension is implemented. 

The following control functions are described herein: 

DECSCNM - Screen Mode 
Line Renditions 

DECSWL - Single Width Line 
DECDWL - Double-Width Line 
DECDHLT - Double-Height Line Top 
DECDHLB - Double-Height Line Bottom 
Character Renditions 

SGR - Select Graphic Rendition 
Color Text Extension (SGR parameters) 

DECCTR - Color Table Report 

DECSTGLT - Select Text /Graphics Look-Up Table 
(Documented Exception) 
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SET/RESET SCREEN MODE DECSCNM 

Levels: 1-4 

Purpose: Change the state of Screen Mode between Normal (reset) 

and Reverse (set) screen. 


Set Format: CSI ? 5 h 

Reset Format: CSI ? 5 1 


Description: A conforming device shall provide the capability of 

operating the physical display in either "normal" [reset state = 
normal] or "reverse" [set state = reverse] screen. The Screen 
Mode setting allows the terminal operator to define his screen 
state with respect to normal character rendition. Changing the 
mode reverses the definitions of the foreground and background 
colors. The actual color values are not specified by the 
architecture, and are implementation defined. All character 
renditions must be achievable as defined on both normal and 
reverse screens . 

Note: Conforming software should not depend on the speed of 

execution when changing Screen Mode . It may take as long as the 
time required to repaint the entire screen, depending on the 
hardware implementation. 


State Affected: 
screen mode 


Algorithm: 

void set_screen_mode 0 

{ 

screen_mode = REVERSE_SCREEN; 

} 


void reset_screen_mode ( ) 

{ 

screen_mode = NORMAL_SCREEN; 

} 


Known Deviations : None 
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5.6.1 Line Renditions 

A conforming device shall support the following line renditions: 

o single-height, single-width 
o single-height, double-width 
o double-height, double-width top 
o double-height, double-width bottom 


Only one rendition may be set per line (they are mutually 
exclusive) . Setting double-width or double-height renditions 
doubles the character cell width within the line, but does not 
affect the addressing of characters in the line (within the 
constraints of the physical display) . For example, the character 
in column 5 of a single-width line will still be addressed as 
column 5 if the line rendition is changed to double-width, 
although the character field will now start in column 9 of the 
physical display. Furthermore, when the line rendition is set to 
double-width or double-height, character positions cannot be 
addressed which are more than half the current value of the right 
edge of the display. 

Note: Conforming software will not draw only the top or the 

bottom of double-height lines. When double-height lines are used, 
both the top and bottom must be displayed in adjacent line 
positions. Otherwise, the visual display of the line and the 
cursor symbol registration is UNDEFINED. 
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SINGLE -WIDTH LINE DECSWL 


Levels: 1-4 

Purpose : Set the Line Rendition of the Active Line to 

single -width 


Format : ESC # 5 

1/11 2/3 3/5 


Description: Setting this attribute causes all characters 

indicated by the codes contained in the Active Line to be 
displayed in single-width rendition. 

Notes : 

1. Setting this attribute on a line which was previously 

double-width will cause the line length to be doubled. 

2. Setting this attribute does not cause data contained in 

the Active Line to be lost . 


State Affected: 

line_rendition [MAX_NUM_LINES] 
active j)Osit ion 


Algorithm: 

void single_width_line 0 

{ 

1 short int base; 

I base = (active_j>osition .page-1) * lines_per_page; 

I 1 ine_rendit ion [act ive_po sit ion . line + base] = SINGLE_WIDTH/ 

} 


Known Deviations : None 
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DOUBLE-WIDTH LINE DECDWL 

Levels: 1-4 

Purpose: Set the Line Rendition of the Active Line to 

double-width . 


Format : ESC # 6 

1/11 2/3 3/6 


Description: Double-width characters are achieved by displaying 

the characters indicated by the codes contained in the Active Line 
in double-width rendition. 

Notes : 

1 . Setting this attribute causes the length of the Active 
Line to be reduced by half. 

2 . Setting this attribute causes data which is beyond the 
end of the Active Line after execution of the control to 
be lost. 

3. This control does not operate when DECLRMM (Left Right 
Margin Mode) is set. 


State Affected: 

line_rendition [MAX_NUM_LINES] 
active_position 

display! MAX_NUM_L INE S ] [ MAX_NUM_COLUMNS ] 
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Algorithm: 

void double_width_line 0 

{ 

column_t x; 

I short int base; 

I base = (active_position .page-1) * lines_per_page; 

I line_rendit ion [active_posit ion . line + base] = DOUBLE_WIDTH; 

if (active_position . column > end_of_line (active_position . line) ) 
active_position . column = end_of_line (act ive_po sit ion . line) ; 
for (x=end_of_line ( act ive_posit ion. line) +1/ 

I x<=columns_per_page; 

I X++) 

I { 

I display [active_posit ion . line + base] [x] . code = EMPTY_CHARACTER; 

} 

} 


Known Deviations: None 
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DOUBLE-HEIGHT LINE DECDHLT, DECDHLB 

Levels: 1-4 

Purpose : Set the Line Rendition of the Active Line to 

double-height top or double-height bottom. 


ESC 

# 

3 

top 

1/11 

2/3 

3/3 


ESC 

# 

4 

bottom 

1/11 

2/3 

3/4 



Description: Double-height characters are achieved by setting 

the Line Rendition of adjacent lines to double-height top and 
double-height bottom. Setting double-height top causes the upper 
half of the characters indicated by the codes contained in the 
Active Line to be displayed in double-height and double-width 
rendition. Setting double-height bottom causes the lower half of 
the characters contained in the Active Line to be displayed in 
double-height and double-width rendition. 

Notes : 

1 . Conforming software will not draw only the top or the 
bottom of double-height lines. When double-height lines 
are used, both the top and bottom must be displayed in 
adjacent line positions. Otherwise, the visual display 
of the line and the cursor symbol registration is 
UNDEFINED. 

2. Since double-height also implies double-width, setting 
this attribute causes the length of the Active Line to be 
reduced by half. 

3. Setting this attribute causes data which is beyond the 
end of the Active Line after execution of the control to 
be lost. 

4. This control does not operate when DECLRMM (Left Right 
Margin Mode) is set. 


State Affected: 

line_rendition [MAX_NUM_LINES] 
active_position 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 
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Algorithm: 

void doub 1 e_he i ght_l ine_t op ( ) 

{ 

column_t x; 

I short int base; 

I base = (active_^osition. page-1) * lines_per_page/ 

I line_rendition [active_position . line + base] = DOUBLE_HEIGHT_TOP; 
if ( act ive__posit ion . column > end_of_line (active_position . line) ) 
act ive_pos it i on . column = end_of_line (active_position . line) ; 
for (x=end_of_line ( act ive_po sit ion . line) +1; 

I x<=columns_per_page; 

I X++) 

I { 

I 

I display [act ive_position . line + base] [x] . code = EMPTY_CHARACTER; 

} 

} 


void double_height_line_bottom ( ) 

{ 

column_t x; 

I short int base; 

I base = (active_position. page-1) * lines_per_page; 

I line_rendition [active_position . line + base] = DOUBLE_HEIGHT_TOP; 
if (active_position . column > end_of_line (active_position . line) ) 
active_position . column = end_of_line (active_position . line) ; 
for (x=end_of_line (active_position . line) +1; 

I x<=columns_per_page; 

I X++) 

I { 

I display [active_position . line + base] [x] . code = EMPTY_CHARACTER; 

} 

} 


Known Deviations: None 
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5.6.2 Character Renditions 

Each character cell in the display has a set of visual attributes 
associated with it. These attributes can be defined using the 
concept of foreground and background values. A character cell 
consists of a rectangular area filled with a background color, and 
a character pattern written in a foreground color. Background and 
foreground values are at least binary in nature (i.e., they must 
have at least two clearly distinguishable visual states) . 
Characters are rendered in the physical display by some 
combination of the background and foreground states. The actual 
values and meanings of the background and foreground colors are 
not specified by the architecture, and are implementation defined. 

A conforming device shall provide normal, bold, underline, blink, 
and reverse renditions for each character in the display. These 
renditions can be combined in any manner for each character 
position independently. The architecture requires that each 
rendition and every possible rendition combination be individually 
distinguishable one from the other, without affecting the ability 
to recognize the character pattern within the cell. Graphic 
renditions apply to all graphic character codes (2/1 to 7/14 
inclusive, and 10/0 to 15/15 inclusive) as well as to the Space 
character (2/0). 


5. 6.2.1 Normal Rendition - 

Normal rendition defines the rendering of characters in the 
physical display in its "natural" state, that is, where the 
character is rendered in the display foreground against a field of 
display background. Normal rendition is the absence of any 
special rendition of the character cell. (Note: Normal rendition 
of characters is dependent on the state of the Screen Mode, which 
is used to define the values of the foreground and background 
colors . ) 


5. 6.2.2 Bold Rendition - Bold rendition of characters may be 
achieved either by emphasizing the display foreground without 
changing the background characteristics of the cell, or by 
intensifying the background color while holding the foreground 
value constant. 


5. 6.2.3 Blink Rendition - Blink rendition is achieved by 
alternating the stable rendition of a character with a different 
rendition at a fixed rate, with a duty cycle of approximately one 
second. 
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5. 6. 2. 4 Underscore Rendition - Underscore rendition is achieved 
by the addition of a single horizontal bar extending the full 
width of the character field and rendered in the display 
foreground. The bar must be easily distinguishable from the 
underline character (5/15) . 


5. 6.2.5 Reverse Rendition - Reverse rendition is achieved by 
using the current value of the foreground color as the cell 
background, and the current value of the background color as the 
foreground. 
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SELECT GRAPHIC RENDITION SGR 


Levels: 1-4 

Purpose: Designate the graphic rendition to be applied to all 

subsequent characters entered into the display. 


Format: CSI Ps ; ... ; Ps m default Ps: 0 

9/11 Ps ; ... ; Ps 6/13 


Description: The SGR control selects the graphic rendition 

(visual attribute) to be applied to all subsequent characters 
entered into the display. The parameter values indicate the 
combination of renditions to be selected as indicated in the 
following table (for both Level 1 and Level 2) : 


Parameter Rendition 

0 All renditions off 

1 Bold 

4 Underscore 

5 Blink 

7 Negative (reverse) image 

The following additional values are recognized in Level 2 
operation. Although these values may be recognized when the 
terminal is operating as a Level 1 device, conforming software 
shall not rely on this feature. 


Parameter Rendition 

22 Normal intensity (Bold off) 

24 Not Underscore 

25 Steady (not Blink) 

27 Positive image 


Notes : 

1. All other parameter values shall be ignored unless they 
are part of a well defined extension to the architecture. 

2. Renditions may be selected in any combination, and will 
be rendered appropriately. Selecting additional 
renditions does not affect the setting of previously 
selected renditions (newly selected renditions will be 
combined with previously selected renditions) unless all 
renditions are turned off (parameter value zero (0) ) . 
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3. In no way does the selection of current rendition affect 
the rendition of characters already entered into the 
display . 


State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 


Algorithm: 

void select_graphic_rendit ion (pare, parv) 
short int pare; 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

short int n; 

if (pare == 0) pare = 1/ 
for (n=0; n<parc; n++) 

{ 

switch (parv [n] ) 

{ 

case 0 : 

current_rendit ion .bold = FALSE; 
current_rendit ion . underscore = FALSE; 
current_rendition .blink = FALSE; 
current_rendit ion . reverse = FALSE; 
break; 
case 1 : 

current_rendition .bold = TRUE; 
break; 
case 4 : 

current_rendit ion . underscore = TRUE; 
break; 
case 5 : 

current_rendit ion .blink = TRUE; 
break; 
case 7 : 

current_rendition . reverse = TRUE; 
break; 
default: 
break; 

} 

if (conformance_level == LEVEL_2) 

{ 

switch (parv [n] ) 

{ 

case 22: 

current_rendition.bold = FALSE; 
break; 
case 24: 

current rendition . underscore = FALSE; 
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break; 
case 25 : 

current_rendit ion .blink = FALSE; 
break; 
case 27: 

current_rendition . reverse = FALSE; 
break; 
default : 
break; 

} 

} 

} 

} 

Known Deviations : None 
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5.6.3 ANSI Color Text Extension 

The Color Text Extension provides for the selection of text 
foreground and background colors on a per character basis using 
SGR color parameters. The Color Text extension may be provided at 
Level 2 or higher of the Character Cell Display service class, and 
is indicated by the extension parameter 22 in the Device 
Attributes (DA) response. 


5. 6.3.1 SGR Color Selection - 

A conforming device shall recognize parameter values 30-37 and 39 
to the SELECT GRAPHIC RENDITION (SGR) control sequence to select 
the foreground color attribute and parameter values 40-47 and 49 
to select the background color attribute, as specified in the 
table. The eight colors listed as factory defaults shall be 
available at a minimum. These colors are taken from the ANSI 
X3 . 64 standard. 


SGR 

meaning 


factory default color 

30 

foreground 

color 

0 

black 

31 

foreground 

color 

1 

red 

32 

foreground 

color 

2 

green 

33 

foreground 

color 

3 

yellow 

34 

foreground 

color 

4 

blue 

35 

foreground 

color 

5 

magenta 

36 

foreground 

color 

6 

cyan 

37 

foreground 

color 

7 

white 

39 

default foreground color 

<device-dependent> 

40 

background 

color 

0 

black 

41 

background 

color 

1 

red 

42 

background 

color 

2 

green 

43 

background 

color 

3 

yellow 

44 

background 

color 

4 

blue 

45 

background 

color 

5 

magenta 

46 

background 

color 

6 

cyan 

47 

background 

color 

7 

white 

49 

default background color 

<device -dependent > 


A device may provide means, either under software or local 
control, to modify these colors and may provide means to save the 
modified colors in non-volatile memory. 


5. 6.3.2 Interaction With Other Visual Renditions - 

The foreground color and background color are maintained as part 
of the current rendition. As new characters are written to the 
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display, the current_rendition is used to update the attribute 
bits associated with each character in display memory. 

Selecting the Reverse Rendition (SGR parameter 7) will, if the 
Reverse Rendition is not already set, be equivalent to invoking 
the current foreground color as the new background color, and the 
current background color as the new foreground color. Likewise, 
selecting the Positive Rendition (SGR parameter 27) will, if the 
Positive Rendition is not already set, be equivalent to invoking 
the current foreground color as the new background color, and the 
current background color as the new foreground color. 

SGR parameters 30-37 and 39, the nine foreground color specifiers, 
will set the foreground color without regard to whether the 
Reverse Rendition is set. Likewise, SGR parameters 40-47 and 49, 
the nine background color specifiers, will set the background 
color without regard to whether the Reverse Rendition is set. 

SGR parameter 0 (all renditions off) will reset the foreground and 
background color attributes to their defaults (equivalent to SGR 
parameters 39 and 49). SOFT TERMINAL RESET (DECSTR) will 
similarly cause the foreground and background color attributes to 
be reset . 

When the Color Text Extension is present, the Bold Rendition (SGR 
parameter 1) should be distinguished by a heavier weight font 
(Guideline) . It is preferable not to use a separate color 
(increased intensity) for bolding in order to keep it distinct 
from the other color text attributes. 

Changing between normal and reverse screen mode (DECSCNM) will 
affect which attribute bits from display memory are used to render 
the text foreground and background color. It does not affect the 
current_rendition, or how the current_rendition is applied to the 
character attribute bits associated with each character in display 
memory . 

The architecture does not specify the default text foreground or 
background colors. It is recommended however that normal screen 
mode correspond to lighter text on a darker background (not 
mandatory) . The factory default for screen mode is device 
dependent . A device may provide means to save the screen mode in 
non-volatile memory so as to override the factory default at 
power-up . 


5. 6.3.3 Color Maps - A color map is a table that associates a 
binary value in display memory with a color that can be produced 
on the display. During display refresh, the active color map is 
used to translate color values from display memory to colors that 
appear on the screen. The size of the active color map cannot 
exceed 2**N entries where N is the number of bits used to 
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represent a color in display memory (often the number of bit 
planes) . 

A device can have many color maps of which only one is active at 
time, or can assign color map entries from a single color map to 
different applications, limiting the size of each application's 
color map. Color maps can be read-only (fixed), or read-write 
(modifiable under software control) . 

Applications often model color selection as asking for a 
particular color (non-indexed, absolute color specification, 
read-only) , or asking for a particular color map entry (indexed 
color, read-write) . When using indexed color, it is normal to 
allow the application to modify a color map entry causing all 
objects written with that color index to change color on the 
display . 

Conforming devices may implement the ANSI SGR colors as indexed or 
non-indexed, and may allow selecting between these two models 
under local control . 
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5. 6.3.4 Color Table Report (DECCTR) - 

A conforming device that supports the TSI and Color Text 
Extensions, and has a color table shall be capable of reporting 
the color table in the form of a DECCTR sequence as follows. 

Color Table Request/Report/Restore DECCTR 


Levels: 2x, 3x, 4x (TSI and Color Text) 

Purpose: To Request, Report, and Restore the contents of 

the color table. 


Request CSI 2 / Pu $ u (DECRQTSR Ps=2) 

Format: 9/11 3/2 3/11 3/? 2/4 7/5 

Report DCS 2 $ s D...D ST (DECTSR Ps=2) 

Format: 9/0 3/2 2/4 7/3 D...D 9/12 

Restore DCS 2 $ p D...D ST (DECRSTS Ps=2) 

Format: 9/0 3/2 2/4 7/0 D...D ST 


Where D...D consists of groups of 5 parameters as follows: 

Pc; Pu; Px; Py; Pz / Pc; Pu; Px; Py; Pz / ... 

Pc is the color number 0-255. 

Pu is the color coordinate system 

0 = illegal 

1 = HLS (hue 0-360, lightness 0-100, saturation 0-100) 

2 = RGB (red 0-100, green 0-100, blue 0-100) 

Px, Py, Px are values in the color coordinate 
system specified by Pu. 

; is the semicolon character (3/11) 

/ is the slach character (2/15) 


Description: DECRQTSR with parameter 2 is sent from the host to 

the terminal to request a color table report . The terminal 
responds with a DECTSR control with parameter 2 and each color 
table entry given as a group of 5 parameters in the data string. 
To load or restore a previously reported color map, the host 
transmits the DECRSTS control with parameter 2 and the desired 
color map definitions in the data string. When loading the color 
map, only the index entries specified are changed. 

When using DECRQTSR to request a color table report, you can 
include an additional parameter Pu to select the color coordinate 
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system the terminal uses to report the color map (0=default, 
1=HLS, 2=RGB) . 


5. 6.3.5 Default Color Assignment (Guideline) - 

When indexed color is used, the following color map assignments 
are recommended to maximize compatibility among implementations 
when the colors are not specified explicitly (not mandatory) . 
"Normal" text foreground and background refers to when Screen Mode 
is reset. 

Four or more plane (16 or more color) color map: 


Color 

Mono 

Text Use 

0 black 

black 

normal background 

1 blue 

gray-2 


2 red 

gray-4 


3 green 

gray- 6 


4 magenta 

gray-1 


5 black 

gray -3 

black text 

6 white 

gray-5 

white text 

7 gray 50% 

white 

normal foreground 

8 gray 25% 

black 


9 blue* 

gray-2 

blue text 

10 red* 

gray-4 

red text 

11 green* 

gray- 6 

green text 

12 magenta* 

gray-1 

magenta text 

13 cyan* 

gray-3 

cyan text 

14 yellow* 

gray-5 

yellow text 

15 gray 75% 

white 

bold text (VT340) 

* = may be 

less saturated 



If more than four planes are supported, this series of 16 colors 
can be repeated as needed. 

Explainatory Note 

DECterm uses these assignments directly, though 
colors corresponding to map entries 9-14 are not 
less saturated. 

The VT340 uses these assignments except that color 
5 is cyan, and color 6 is yellow. These were 
changed to black and white to make black and white 
ANSI text colors not dependent on the default 
foreground and background colors in DECterm. 
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Color map entries 0-3 match the VT240 default 
colors . 
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5 . 6 . 3 . 6 Color Interaction Among Modes And Data Syntaxes 
(Guideline) - 

ANSI Color Text, Sixels, and ReGIS can all support indexed color 
using a similar color model. A conforming device may share a 
single color map among these protocols so that changing a color 
definition in one protocol will affect the color map used by the 
other protocols. Support for the option of sharing the same color 
map is recommended, but not mandatory. Conforming software should 
not depend on cross protocol side effects if maximum portability 
is desired. 


5. 6.3.7 Alternative Text Rendition Mapping (Guideline) - 

Some previous terminals which do not support ANSI Color Text 
allowed other SGR parameters to select text colors. 

VT241 

Color Entry 


0 normal text background 

1 reverse graphic rendition (SGR 7) 

2 bold graphic rendition (SGR 1) 

3 normal text foreground 

For backward compatibility, the VT340 provides an alternative text 
rendition mapping mode selectable from Set-Up. 

VT340 Alternative Text Rendition Mapping 
Color Entry 


0 normal text background 
8 reverse graphic rendition (SGR 7) 

15 bold graphic rendition (SGR 1) 

7 normal text foreground 

When alternative text rendition mapping is not selected, the 
reverse attribute is rendered by exchanging the text foreground 
and background colors . 

A conforming device may provide an alternative text rendition 

mapping mode selectable in Set-Up, but this is not part of the 

Color Text Extension. The factory default behavior should be to 
treat bold and reverse graphic renditions independently of color 
selection (not mandatory) . 
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Select Text /Graphics Look-Up Table DECSTGLT 

Levels: 3 (Documented Exception) 

Purpose: To select color look-up table used and the mapping 

of text renditions to look-up table entries . 


Format : 


CSI Ps ) { 

9/11 3/? 2/9 7/11 

Ps Look-Up Table 


0 monochrome look-up table (default) 

1 color look-up table, 
standard text rendition mapping 

2 color look-up table, 

alternative text rendition mapping 


Description: DECSTGLT permits host selection of the video color 

look-up table used in the device, and the mapping of text 
renditions to look-up table entries. This control function 
assumes the existence of two color look-up tables: monochrome and 
color. When a color look-up table is selected, two text rendition 
mappings can be defined, called "standard" and "alternative". The 
"standard" mapping permits the reverse video rendition to use a 
different color look-up table entry for the background of 
displayed text. The "alternative" mapping restricts text 
rendition mapping to a single background entry, and one or two 
foreground entries (two if the bold graphic rendition is effected 
through increased intensity) . In other words, the alternative 
mapping supports the use of bold and reverse graphic renditions to 
select text foreground colors. 

This control function is not intended to supplant the Color Text 
Extension, but instead provide a means of backward compatibility 
to earlier video devices which provided several different text 
rendition mappings based on different monitor configurations. 
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5.7 AUDIBLE INDICATOR 

A conforming device shall provide a warning "bell", or some 
similar audible indicator suitable to signal the operator's 
attention. It may be possible to change the volume of the bell 
sound, or disable it entirely, as a local Setup function. 


WARNING BELL BEL 

Levels: 1-4 

Purpose : Rings the terminal bell . 


Format : BEL 

0/7 


Description: The BEL control causes the terminal to emit an 

audible tone of brief duration. 


Notes : 

1 . It may be possible to change the volume of the bell 

sound, or disable it entirely, as a local Setup function. 


State Affected: none 
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5.8 GRAPHIC CHARACTER SETS 

The terminal shall maintain a repertory of available character 
sets which may be used to interpret received data characters to be 
displayed. The character sets must be selectable on a per 
character basis, and are mutually exclusive (that is, there can be 
only one character set value for each character position in the 
Logical Display) . Refer to the Code Extension Chapter of this 
standard (DEC STD 70-3) for more information on designating and 
invoking character sets, G-sets, and the structure of the in-use 
table . 


5.8.1 Character Set Repertoire 

The table below shows the graphic character sets required at each 
Conformance Level, and those available as Extensions. 

Level at which required. 

Character Set (s) or availabe as Extension 


U.S. ASCII 

1-4 



DEC Line Drawing 

1-4 



DEC Supplemental Graphic 

2-4 



ISO Latin- 1 Supplemental 

2x, 

3-4 


UPSS 

2x, 

3-4 


UK set (United Kingdom) 

lx 



NRCS 

lx. 

2x, 

3x 

JIS ROMAN, JIS KATAKANA 

2x, 

3x, 

4x 

DRCS 

2x, 

3x, 

4x 

DEC Technical 

3x, 

4x 



Notes : 

1. ISO Latin-1 Supplemental is available at Level 2 as part 
of the 8-bit Interface Architecture Extension. 

2. UPSS (User Preference Supplemental Set) is not actually a 
character set in itself, but a pointer to one of the 
supplemental sets (usually DEC Supplemental or ISO 
Latin- 1 Supplemental) . UPSS is available at Level 2 as 
part of the 8-bit Interface Architecture Extension. 

3. The UK set is an optional extension to Level 1 which if 
present, may be selected in Set-Up to replace ASCII 
(ASCII and UK cannot be designated simultaneously) . This 
extension was implemented on the VTIOO, but has since 
been replaced by the NRCS Extension. 

4. NRCS (National Replacement Character Set) is an extension 
which provides twelve 7-bit NRC sets, one of which may be 
selected under local user control (Set-Up) to replace 
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U.S. ASCII as the default set. See DECNRCM. Depending 
on the implementation, only one NRC set corresponding to 
the keyboard dialect may be selectable at a time. 

5. JIS_ROMAN and JIS_KATAKANA are part of the Katakana 
Extension . 

6. DRCS (Dynamically Redefinable Character Set) is an 
extension which allows a soft character set to be 
downloaded from the host and assigned a designating 
sequence possibly replacing an existing character set. 
See Chapter 10 of this standard (DEC STD 70-10) , DRCS 
Extension . 


The character sets themselves are described in DEC STD 169 Digital 
Standard Coded graphic Character Sets for Hardware and Software. 


5.8.2 Character Set Selection 

Character sets are identified to the terminal using designating 
escape sequences which must be registered in DEC Standard 138. 

Each sequence consists of zero, one, or two intermediate 
characters in the range 2/0 through 2/15, followed by a final 
character in the range 3/0 through 7/15, the combination of which 
uniquely identifies the character set to be designated. (Note: 
the designating sequence is preceded by the Escape character 
(1/11) and a single intermediate value 2/8, 2/9, 2/10, or 2/11 
indicating which of the four G-sets the specified character set is 
to be designated into. For a complete description of the 
designating and invoking process, see the section "Code Extension 
Layer", DEC STD 70-3.) 
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DESIGNATE CHARACTER SET 


SCS 


Levels: 1-4 

Purpose: Designate the graphic character sets. 


Format: ESC <G-Set designator> <Character set designator> 

The G-Set designators are: 


94 character sets 
GO ( 2/8 

G1 ) 2/9 

G2 * 2/10 

G3 + 2/11 

96 character sets 
G1 - 2/13 

G2 . 2/14 

G3 / 2/15 


The Character set designators are : 


ASCII_G B 

LINE_DRAWING_G 0 

DEC_SUPPLEMENTAL_G %5 

ISO_LATINl_SUPPLEMENTAL_G A 
UPSS_G < 

DRCS_G I I F 

TCS_G > 

JI S Roman J 

JIS Katakana I 


4/2 

3/0 

2/5 3/5 

4/1 

3/12 

2 /? 2 /? ?/? 

4/10 

4/9 


NRCS 

British 

Dutch 

Finnish 

French 

French Canadian 

German 

Italian 

Norwegian/Danish 

Portuguese 

Spanish 

Swedish 

Swiss 


A 

4 

5 or C 
R 

Q 

K 

Y 

E or 6 
%6 
Z 

7 or H 


(discontinued in L3) 


For example, 

ESC ( B designates ASCII_G to GO 
ESC ) 0 designates Line Drawing to G1 
ESC * < designates the UPSS to G2 
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Description: The character set designating escape sequences 

provide the means of selecting the GO, Gl, G2, and G3 character 
sets, which can be invoked into the left (GL) and right (GR) sides 
of the In Use Table. (For a complete description of the G-sets 
and the In Use Table, see the section "Code Extension Layer".) 

Notes: 

1 . In Level 1 operation character sets can only be 
designated into GO and Gl, with G2 and G3 containing the 
ASCII character set by default. 

2 . Conforming software will not change the default 
designations of the GO and G2 character sets. The Gl and 
G3 sets will be used when it is desired to designate 
alternate character sets. Furthermore, conforming 
software will not designate ASCII_G to either G2 or G3, 
and will not designate Supplemental_G to either GO or Gl . 

3. Designating a character set which is invoked into the In 
Use Table at the time the control is executed causes the 
In Use Table to be changed to reflect the change to the 
designated set. 

4. As a Level 1 extension, the UK (United Kingdom) Character 
Set may be provided, and designated with the sequence ESC 
I A (1/11 I 4/1) . If this extension is supported, it may 
also be possible to locally select the UK set to replace 
ASCII as the default 7-bit set. In this case, the UK set 
will be used in all instances in which ASCII is employed 
throughout the Video Systems Reference Manual when the 
terminal is in Level 1 operation. 

5. On traditional video terminals with the NRCS extension, 
it is permissable to only recognize the one NRC set 
corresponding to the keyboard dialect at a time. 
Workstation terminal emulators may extend the character 
set table to recognize all NRC sets regardless of the 
current keyboard dialect (not mandatory) . 


State Affected: 

designated_graphic_set s [ 4 ] 
in use table 
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Algorithm: 

/*************** 

* 

* Initialize the character set table 

* This procedure should be called on power-up or 

* reset to initialize the character set table 

* with the appropriate designating sequences. 

* 

**************/ 

void intialize_character_set_table () 

{ 

char_set_table [TABLE_ASCII ] . name = ASCII_G; 
char_set_t able [TABLE_ASCII] . fir st_intermediate = 0; 
char_set_table [TABLE_ASCII] . second_intermediate = 0; 
char_set_table[TABLE_ASCII] .final = 'B'; 

char_set_t able [TABLE_LINE_DRAWING] .name = LINE_DRAWING_G; 
char_set_table [TABLE_LINE_DRAWING] . f irst_intermediate = 0; 
char_set_table [TABLE_LINE_DRAWING] . second_intermediate = 0; 
char_set_table[TABLE_LINE_DRAWING] .final = ' 0' ; 

if (conf ormance_level >= LEVEL_2) 

{ 

char_set_t able [TABLE_DEC_SUPP] .name = DEC_SUPPLEMENTAL_G/ 
char_set_table [TABLE_DEC_SUPP] . f irst_intermediate = 
char_set_table [TABLE_DEC_SUPP] . second_intermediate = 0/ 
char_set_table[TABLE_DEC_SUPP] .final = ' 5 '; 

if {level_2_extensions [DRCS_EXT] ==TRUE) 

{ 

char_set_t able [TABLE_DRCS] .name = DRCS_G; 
char_set_table [TABLE_DRCS] . first_intermediate = 0; 
char_set_table [TABLE_DRCS] . second_intermediate = 0; 
char_set_table [TABLE_DRCS] . final = 0; 

} 

if (level_2_extensions [NRCS_EXT] ==TRUE) 

{ 

/* 

This entry is initialized to correspond 
with the keyboard dialect whenever it 
is changed in Set-Up. 

*/ 

char_set_t able [TABLE_NRCS] .name = NRCS_G/ 
char_set_table [TABLE_NRCS] . f irst_intermediate =0; 
char_set_table [TABLE_NRCS] . second_intermediate = 0; 
char_set_t able [TABLE_NRCS] . final =0; 

} 

} 

if ( (conf ormance_level >= LEVEL_3) I | 

(level_2_extensions [EIGHT_BIT_IA] ==TRUE) ) 

{ 

char set table [TABLE LATINl] .name = ISO LATINl SUPPLEMENTAL G; 
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char_set_table [TABLE_IjATIN 1 ] . f irst_intermediate = 0/ 
char_set_table [TABLE_IiATINl ] . second_intermediate = 0; 
char_set_t able [TABLE_LATIN1] . final = 'A'; 

char_set_table [TABLE_UPSS] .name = UPSS_G; 
char_set_table [TABLE_UPSS] . first_intermediate = 0; 
char_set_table [TABLE_UPSS] . second_intermediate = 0; 
char_set_table [TABLE_UPSS] . final = 

} 

if (level_3_extensions [TCS] ==TRUE) 

{ 

char_set_t able [TABLE_TCS] . name = TCS_G; 
char_set_table [TABLE_TCS] . first_intermediate = 0; 
char_set_table [TABLE_TCS] . second_intermediate =0; 
char_set_t able [TABLE_TCS] . final = ' >' } 

) 


void designate_character_set (pare, parv) 

/* pare and parv contain the count and values 
of the indermediate characters of the 
designating sequence */ 
short int pare; 

short int parv [MAX_NUM_INTERMEDIATES] / 

{ 

short int n; 

short int gset_number; 

short int set_size; 

boolean t compare designator () ; /* function declaration */ 

/* */ 

/* find which set we're designating */ 
switch (parv[0]) 

{ 

case /* 2/8 designate 94 into GO */ 

gset_number = 0; 
set_size = 94/ 
break; 

case ' : /* 2/9 designate 94 into G1 */ 

gset_number = 1/ 
set_size = 94; 
break; 

case /* 2/10 designate 94 into G2 */ 

gset_number =2/ 
set_size =94; 
break; 

case /* 2/11 designate 94 into G3 */ 

gset_number = 3; 
set_size = 94; 
break; 
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case ' : /* 2/13 designate 96 into G1 */ 

gset_number = 1; 
set_size = 96; 
break; 

case ' : /* 2/14 designate 96 into G2 */ 

gset_number = 2; 
set_si 2 e = 96; 
break; 

case '/': /* 2/15 designate 96 into G3 */ 

gset_number = 3; 
set_size = 96; 
break; 

} 

/* look for the designator in the table */ 

/* 

Note that because the DRCS designator is processed last, 
it will replace an installed set if the designator is 
identical . 

*/ 

for (n=0; n<MAX_NUM_CHAR_SETS; n++) 

{ 

if ( compare_designator (pare, parv, n) ) 

{ 

designated_graphic_sets [gset_number] = 
char_set_table [n] .name; 

} 

} 


/* update the in_use_table with 

the latest designations (if any) 
for the invoked gsets */ 
in_use_table . gl = 

designated_graphic_sets [in_use_table . invoked_gl] ; 
if (conf ormance_level >= LEVEL_2) 

{ 

in_use_table.gr = 

designated_graphic_sets [ in_use_table . invoked_gr] ; 

} 

/* perform hardware specific actions needed 
to update the character set displayed */ 

} /* end procedure designate_character_set */ 


/* 

* compare sequence designator to table entry n 
*/ 

boolean_t compare_designator (pare, parv, n) 

short int pare; /* number of sequence characters */ 
short int parv [MAX_NUM_INTERMEDIATES] ; 
short int n; /* char set table entry */ 


boolean t status; 
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status = TRUE; 

if (char_set_table [n] . final != parv [parc-1 ] ) 
status = FALSE; 
else 
{ 

if (pare > 2) 

{ 

if (char_set_table [n] . f irst_intermediate != parv[l]) 
status = FALSE; 
else 
{ 

if (pare >= 3) 

if (char_set_table [n] . second_intermediate != parv[2]) 
status = FALSE; 

} 

} 

} 

return (status) ; 

} 


Known Deviations: None 
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ASSIGN USER-PREFERENCE SUPPLEMENTAL SET DECAUPSS 


Levels: 2x (8-bit Interface Architecture), 3-4 

Purpose: To assign a user preferred supplemental set 


Format : DCS Ps ! u Dscs ST 

9/0 2/1 7/5 9/12 


Description: This control string assigns a character set to be 

the User-Preference Supplemental Set (UPSS) . The User-Preference 
Supplemental Set serves the following functions: 

1. It acts as the default supplemental set for reception. 

On soft terminal reset, the UPSS is designated as G2 . 

2. It acts as the keyboard supplemental set, that is, it 
determines which supplemental characters can be generated 
from the keyboard (including valid compose sequences) . 

3. It provides a level of indirection for application 
software. The UPSS can be explicitly designated without 
needing to know the actual character set assigned. 

Currently DEC Supplemental and ISO Latin-1 supplemental may be 
used as the UPSS. The default User-Preference Supplemental Set is 
determined through a Set-Up feature. The value of Ps and Dscs 
denote which set from the terminal's repertory of character sets 
is to be the User-Preference Supplemental Set . 

Ps selects between 94 and 96 character sets (Ps = 0 selets a 94 
character set) . Dscs is the intermediate and final characters of 
the SCS escape sequence used to explicitly designated that 
character set. For example a value of "% 5" for Dscs indicates 
that the DEC Supplemental character set is the User-Preference 
Supplemental set. See the SCS command for more information on the 
designating intermediate and final characters. Attempts to assign 
an invalid supplemental set will be ignored. 

Notes on DECAUPSS: 

1 . The DRCS can be used as the UPSS by naming it as DEC 
Supplemental or ISO Latin-1 supplemental. 

2. Assigning a new UPSS will immediately update the In-Use 
table if the UPSS is currently designated and invoked. 

3. This sequence is sent from the terminal to the host in 
response to a DECRQUPSS request. 
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Implementation Guideline 
The valid combinations for the VT320 are: 

Ps = 0, Dscs = % 5 DEC Supplemental 

Ps = 1, Dscs = A ISO Latin-1 supplemental graphic 

State Affected: 

upss /* defined in code extension layer */ 


Algorithm: 

void assign_user_preference_set (parv, string) 
short int parv [MAX_NUM_PARAMETERS] ; 
char string[]/ 

{ 

if ( (conf ormance_level >= LEVEL_3) | | 

(level_2_extensions [EIGHT_BIT_IA] == TRUE)) 

{ 

/* update upss state in Code Extension Layer */ 
if ((parv[0] = 0) && (strcmp (string, ”%5") == 0)) 

{ 

/* size is 94 characters */ 
upss = DEC_SUPPLEMENTAL_G; 

} 

else if ( (parv[0] = 1) && (strcmp (string, "A") == 0)) 

{ 

/* size is 96 characters */ 
upss = IS0_LATIN1_SUPPLEMENTAL_G; 

} 

/* update in use table */ 
if (in_use_table . gl == UPSS_G) 

{ 

; /* perform hardware dependent actions as needed */ 

} 

if (in_use_table.gr == UPSS_G) 

{ 

; /* perform hardware dependent actions as needed */ 

} 

} 

} 


Known Deviations: None 
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REQUEST USER-PREFERENCE SUPPLEMENTAL SET DECRQUPSS 


Levels: 2x (8-bit Interface Architecture), 3-4 

Purpose : To request the user preferred supplemental set 


Format: CSI & u 

9/11 2/6 7/5 


Description: Upon receipt of this sequence, the terminal will 

return a DECAUPSS sequence which specifies which coded character 
set is assigned to be the User-Preference Supplemental Set. 


State Affected: none 


Algorithm: 

void request_user_preference_set 0 

{ 

if ( (conf ormance_level >= LEVEL_3) | | 

(level_2_extensions [EIGHT_BIT_IA] == TRUE)) 

{ 

send_char (0x90, host_port) ; /* DCS */ 

if (upss = DEC_SUPPLEMENTAL_G) 

{ 

send_int (0, host_port) ; 
send_string ( " !u%5", host_port) ; 

} 

else if (upss = ISO_LATINl_SUPPLEMENTAL_G) 

{ 

send_int(l, host_port) ; 
send_string ( " ! uA" , host_port ) / 

} 

send_char (0x9C, host_port) ; /* ST */ 

} 

} 


Known Deviations: None 
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SET/RESET CHARACTER SET MODE DECNRCM 

Levels: lx, 2x, 3x, 4x (NRCS Extension) 

Purpose: To select 8-bit Multinational Characters, or 7-bit NRCS 

Characters for transmission (keyboard) and reception (display) . 


To set: CSI ? 42 h (7-bit NRCS Characters) 

To reset: CSI ? 42 1 (8-bit Multinational Characters) 


Description: This parameter is applicaple to the Set Mode and 

Reset Mode control sequence. When 8 -bit Multinational Characters 
is selected (factory default) , the terminal uses ASCII in GL and 
either DEC Supplemental or ISO Latin-1 Supplemental in GR 
(depending on the UPSS) . When 7-bit NRCS Characters is selected, 
a 7-bit National Replacement Character set is used for 
transmission and reception in GL (GR is not used) . The NRCS used 
is determined by the Keyboard Dialect chosen in Set-Up (see 
"Keyboard Processing", DEC STD 70-6) . 

Notes on DECNRCM: 

1. Changing this mode has the side effect of re-initializing 
the designated and invoked character sets to their 
default state (the state at power-on or reset) . If 7-bit 
NRCS Characters is selected, a 7 -bit NRC Set may replace 
U.S. ASCII in the default designations. 

2. 8-bit Characters are temporarily disabled when in Level 1 
(VTIOO mode) , or a 7-bit host line environment is 
selected. The DECNRCM secpaence will still be recognized, 
but in the case of the reset sequence, 8 -bit characters 
will remain disabled until the restrictive conditions are 
removed . 

3 . This sequence is ignored when the North American or Dutch 
Keyboard Dialect is selected. These keyboard dialects 
use U.S. ASCII as their 7-bit set, so there is no need 
to disable the multinational set (which includes U.S. 
ASCII as its left half) to access 7-bit NRC characters. 
U.S. ASCII may be considered the NRC set for North 
America . 


State Affected: 

character_set_mode 

r_character_set_mode 

/* used to keep track of character set mode 

when a restrictive condition (7 -bit Host Line, 
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or VTIOO mode) is in effect */ 
in_use_table 

designated_graphic_sets [4] 


Algorithm: 

void set_character_set_mode 0 

{ 

if (level_l_extensions [NRCS_EXT] ==TRUE) 

{ 

character_set_mode = SEVEN_BIT_NATIONAL; 

/* keep track of mode if there are restrictions in effect */ 
r_character_set_mode = SEVEN_BIT_NATIONAL; 
if (keyboard_usage_mode == TYPEWRITER) 

{ 

in_use_table . gl = nrcs_list [keyboard_dialect] / 
in_use_table.gr = nrcs_list [keyboard_dialect] ; 
in_use_table . invoked_gl = GO; 
in_use_table . invoked_gr = G2; 

designated_graphic_sets [ 0 ] = nrcs_list [keyboard_dialect ] ; 
designated_graphic_sets [ 1 ] = nrcs_list [keyboard_dialect ] ; 
designated_graphic_sets [2 ] = nrcs_list [keyboard_dialect ] ; 
designated_graphic_sets [3] = nrcs_list [keyboard_dialect ] ; 

} 

else /* keyboard usage mode is Data Processing */ 

{ 

in_use_table . gl = ASCII_G; 
in_use_table.gr = ASCII_G; 
in_use_table . invoked_gl = GO; 
in_use_table . invoked_gr = G2; 
designated_graphic_sets [0] = ASCII_G; 
designated_graphic_sets [1] = ASCII_G; 
designated_graphic_sets [2] = ASCII_G; 
designated_graphic_sets [3] = ASCII_G; 

} 

} 


void reset_character_set_mode 0 

{ 

if (level_l_extensions [NRCS_EXT] ==TRUE) 

{ 

/* keep track of mode if there are restrictions in effect */ 
r_character_set_mode = EIGHT_BIT_MULTINATIONAL; 

/* ignore if 7-bit host line or VTIOO mode */ 
if ( (host_port_environment != SEVEN_BIT) && 

(conf ormance_level != LEVEL_1) ) 

{ 

character_set_mode = EIGHT_BIT_MULTINATIONAL; 
in_use_table . gl = ASCII_G; 
in_use_table.gr = UPSS_G; 
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in_use_table . invoked_gl = GO; 
in_use_table . invoked_gr = G2/ 
designated_graphic_sets [0] = ASCII_G/ 
designated_graphic_sets [1] = ASCII_G; 
designated_graphic_sets [2 ] = UPSS_G; 
designated_graphic_sets [3] = UPSS_G; 

} 

} 

} 


Known Deviations: None 


5.9 SUMMARY OF CONTROL CHARACTER PROCESSING 

This subsection provides a summary of control character processing 
as a convenience to the reader, and to include control characters 
which are not described in detail in their corresponding 
functional subsection of this chapter (DEC STD 70-5) . 


5.9.1 CO Control Characters 

CO control characters are those with values of 0/0 to 1/15, and 
7/15 (0 - 31, and 127 decimal) . The following is a description of 
the control characters recognized by conforming devices . All 
other CO control characters cause no action to be taken. 

Control Col/Row Action Taken 


NUL 0/0 Ignored on input (not 

stored in input buffer) . 

May be used as a time fill 
character. Note: When 
Control Representation Mode 
is Set, NUL is not ignored, 
but displayed, and may not 
be used as a time fill 
character . 

ENQ 0/5 Transmit answerback message. 

BEL 0/7 Causes bell tone to sound 

from keyboard. 

BS 0/8 Causes the cursor to move 

to the left one character 
position, unless it is at 
the left margin. Does not 
cause wrap. 
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HT 0/9 Causes the cursor to move 

to the next tab stop, or 
the right margin if no 
further tab stops . Does 
not cause wrap . 

LF 0/10 Causes a line feed or a new 

line operation depending on 
the setting of Line Feed/New 
Line Mode (LNM) . LF causes 
a line to be printed if in 
auto print mode . 

VT 0/11 Interpreted as a LF. 

FF 0/12 Interpreted as a LF. 

CR 0/13 Cursor goes to left margin. 

If cursor is already left of the left 
margin, cursor goes to column 1. 

50 0/14 Invoke G1 character set into GL. 

(LSI) 

51 0/15 Invoke GO character set into GL. 

(LSO) 

XON 1/1 Causes terminal to resume 

transmitting, if XOFF 
handling is enabled. 

XOFF 1/3 Causes terminal to stop 

transmitting all codes 
except XOFF and XON, if 
XOFF handling is enabled. 

CAN 1/8 If received during an escape or 

control sequence, the sequence 
is immediately terminated and 
not executed. No character is 
displayed. 

SUB 1/10 If received during an escape or 

control sequence, the sequence 
is immediately terminated and 
not executed. The error 
character (reverse question mark) 
is displayed. 

ESC 1/11 Introduces an escape sequence. 

Terminates any escape, control sequence, 
or control string in progress. 
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DEL 7/15 Ignored on input (not 

stored in input buffer) . 

May not be used as a time fill 
character . 


5.9.2 Cl Control Characters 

Cl control characters are those with positions of 8/0 to 9/15. 

The following is a description of the Cl control characters which 
are recognized by conforming devices. All other Cl control 
characters cause no action to be taken. 

Note Cl controls can be represented by ESC Fe sequences in 7-bits. 
See "Code Extension Layer" (DEC STD 70-3) . 

Control Col/Row Action Taken 


IND 


NEL 


HTS 


RI 


8/4 INDEX - Causes the active 

position to move downward 
one line without changing 
the horizontal position. 

If the active position is 
at the bottom margin, a 
scroll up is performed. 

8/5 NEXT LINE - Causes the 

active position to move 
to the first position on 
the next line downward. 

If the active position is 
at the bottom margin, a 
scroll action is performed, 
(a CR LF is executed) . 

8/8 HORIZONTAL TABULATION SET 

Sets one horizontal 
tabulation stop at the 
column of the active 
position (See also, TBC) . 

8/13 REVERSE INDEX - Moves the 

active position to the 
same horizontal position 
on the preceding line. 

If the active position is 
at the top margin, a 
scroll down is performed. 
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SS2 


SS3 


DCS 


SOS 


8/14 SINGLE SHIFT 2 - Causes 

the G2 set to be invoked 
for the next single 
displayed character. 

8/15 SINGLE SHIFT 3 - Causes 

the G3 set to be invoked 
for the next single 
displayable character. 

9/0 DEVICE CONTROL STRING - 

Introduces a Device 
Control String. 

9/8 START OF STRING - 

This control is ignored. 


DECID 9/10 
(reserved) 


DEC PRIVATE IDENTIFICATION - 
Causes the same response as 
the ANSI device attributes 
(see DA) . This sequence is 
not recognized a Level 3 or 
above. Conforming software 
shall use DA. Note: If 
printer controller mode is 
enabled;^ the sequence will be 
sent to the printer. 


CSI 

9/11 

CONTROL SEQUENCE INTRODUCER - 
Introduces a control sequence 

ST 

9/12 

STRING TERMINATOR - 
Terminates Control 

Strings introduced by 

DCS, APC, OSC, and PM. 

OSC 

9/13 

Operating System Command - 
A control string. 

PM 

9/14 

Privacy Message - 
A control string. 

APC 

9/15 

Application Program Command - 
A control string. 


-131 
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SUBSTITUTE SUB 


Levels: 1-4 

Purpose: Place a reversed question mark symbol in the display. 

Format : SUB 

1/10 


Description: The SUB control is used to indicate the presence 

of characters in the data stream for which there is no graphic 
representation. This control is processed by placing a reversed 
question mark in the display at the Active Position. 

Notes : 

1 . The character to be displayed in cases where the reversed 
question mark cannot be used is a "half-tone blotch", 
which is rendered by filling the entire character cell in 
the display with a cross-hatched pattern. 

2 . Receipt of the Substitute character within an escape or 
control sequence causes the sequence in progress to be 
aborted and the Substitute control function to be 
executed instead (that is, the reversed question mark 
symbol will be displayed) . (See the section "Code 
Extension Layer" for a complete description of the 
handling of control characters within escape and control 
sequences . ) 

State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS ] 
active_position 

Algorithm: 

void substitute 0 

{ 

short int sub = OxlA; 

/* */ 

/* place a reversed question mark in the display */ 
insert_or_replace_character (&sub) ; 

} 

Known Deviations: 

Most existing terminals (VTIOO, VTlOl, VT102, VT125, VT131, VT132) 
display the blotch character instead of the reversed question 
mark . 
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5.10 MODES STATES (AND MODE DESCRIPTIONS) 

A conforming device shall provide certain programmable state 
capabilities or modes as described below. It should be noted that 
some modes are identified as User Preference Features (see the 
section "Concepts and Conformance Criteria" for a list of the 
modes which are classified as User Preference Features) . The 
state of these features should not be changed by donforming 
software, except in response to an explicit user request (for 
example, a request to change the screen width) . 


5.10.1 SM/RM - Set Mode, Reset Mode Sequence 

The Set Mode/Reset Mode control sequence is used to control the 
state of various settable modes in the terminal . 


Set Format : 

CSI 

9/11 

PS. 
Ps . 

. .Ps 
. .Ps 

1 

6/12 

Reset Format : 

CSI 

9/11 

Ps. 

Ps. 

. .Ps 
. .Ps 

h 

6/8 


Sets/Resets one or more modes of the terminal as specified by each 
selective parameter in the parameter string. Each mode to be 
set/reset is specified by a separate parameter. 

Note that ANSI specified mode parameters and DEC private mode 
parameters may not be mixed within the same SM or RM sequence . 


5.10.1.1 ANSI Specified Modes: - 


Mode 

Parameter Mnemonic Mode Function 


0 

2 

4 

12 

20 



Error (ignored) 


KAM 

Keyboard Action Mode 

IRM 

Insert Replacement 

Mode 

SRM 

Send-Receive Mode 


LNM 

Line Feed New Line 

Mode 


5.10.1.2 DEC Private Modes: - 

If the first character in the parameter string is 3/15 (?) , the 
parameters are interpreted as DEC private parameters, according to 
the following table. 
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Mode 


Parameter 

Mnemonic 

Mode Function 

0 


Error (ignored) 

1 

DECCKM 

Cursor Key Mode 

3 

DECCOLM 

Column Mode 

4 

DECSCLM 

Scrolling Mode 

5 

DECSCNM 

Screen Mode 

6 

DECOM 

Origin Mode 

7 

DECAWM 

Autowrap Mode 

8 

DECARM 

Autorepeating Mode 

18 

DECPFF 

Print Form Feed 

19 

DECPEX 

Pr: nt Extent 

25 

DECCEM 

Cursor Enable Mode 

38 

DECTEK 

Tektronix 4010/4014 Mode 

42 

DECNRCM 

National Character set mode 

61 

DECVCCM 

Vertical Coupling 

64 

DECPCCM 

Page Coupling 

68 

DECKBUM 

Keyboard Usage Mode 

69 

DECLRMM 

Left Right Margin Mode 

73 

DECXRLM 

Transmit Rate Limiting 


Any other parameter values are ignored. 


5.10.1.3 Modes That Cannot Be Changed - The following modes which 
are specified in the ANSI X3. 64-1979 standard may be considered to 
be permanently set, permanently reset, or not applicable, as 
noted. Refer to that standard for further information concerning 
these modes . 

Mode 


Mnemonic 

Mode Function 

State 

EBM 

Editing Boundary Mode 

Reset 

FEAM 

Format Effector Action Mode 

Reset 

FETM 

Format Effector Transfer Mode 

NA 

HEM 

Horizontal Editing Mode 

Reset 

MATM 

Multiple Area Transfer Mode 

NA 

PUM 

Positioning Unit Mode 

Reset 

SATM 

Selected Area Transfer Mode 

NA 

SRTM 

Status Reporting Transfer Mode 

Reset 

TSM 

Tabulation Stop Mode 

Reset 

VEM 

Vertical Editing Mode 

Reset 


5.10.2 Mode Descriptions 

The detailed descriptions for many of the modes that use the SM/RM 
sequences are included in other parts of this standard (DEC STD 
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70) to keep related functions together. 


SET/RESET SEND RECEIVE MODE SRM 

Levels: 1-4 

Purpose: To turn the local echo feature ON or OFF 

Set Format: CSI 12 h (local echo off, default) 

Reset Format: CSI 12 1 (local echo on) 


Description: SRM is a parameter applicable to the Set Mode and 

Reset Mode control sequences. The reset state causes local echo 
to be ON. The set state causes local echo to be OFF. 

NOTE 

Local echo is temporarily disabled when either or 
both of the following conditions are true: 

The terminal is in printer controller mode 
The terminal is in local mode 


State Affected: 

send_receive_mode /* See Keyboard Processing */ 
r send receive mode 
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Algorithm: 

void set_send_receive_mode 0 

{ 

send_receive_mode = ECHO_OFF; 

/* remember state in case there are restrictions */ 
r_send_receive_mode = ECHO_OFF; 

} 


void reset_send_receive_mode 0 

{ 

/* remember state in case there are restrictions */ 
r_send_receive_mode = ECHO_ON/ 

if ( (printer_controller_mode != PRINTER_CONTROLLER_ON) && 
(line_local_mode != LOCAL)) 
send_receive_mode = ECHO_ON/ 

} 


Known Deviations: None 
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5.11 EDITING FUNCTIONS 

This subsection describes the following functions used to edit 
data, or control editing in the Logical Display. 

IRM - Insert /Replacement Mode 

ICH - Insert Character 

DCH - Delete Character 

IL - Insert Line 

DL - Delete Line 

DECIC - Insert Column 

DECDC - Delete Column 

ECH - Erase Character 

EL - Erase in Line 

DECSEL - Selective Erase in Line 

ED - Erase in Display 

DECSED - Selective Erase in Display 

Character Attributes (selective erase) 

DECSCA - Select Character Attribute 
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SET/RESET INSERT /REPLACEMENT MODE IRM 


Levels: IX, 2-4 

Purpose: Change the state of Insert /Replacement Mode between 

Replace (reset) and Insert (set) graphic characters. 


Set Format: CSI 4 h 

Reset Format: CSI 4 1 


Description: A conforming device shall provide the ability to 

select whether characters entered into character positions which 
already contain data shall overwrite the character at that 
position [reset state = replace] , or shall be inserted by causing 
all data on the line starting at the Active Position to be shifted 
one column to the right to accommodate the new character [set 
state = insert] . 

Notes : 

1 . The IRM controls are part of the Level 1 Editing 

Extension. This extension is required in all new Level 1 
implementations. They are required functions in Level 2. 


State Affected: 

insert_replacement_mode 

Algorithm: 

void set_insert_replacement_mode () 

{ 

insert_replacement_mode = INSERT; 

} 


void reset_insert_replacement_mode () 

{ 

insert_replacement_mode = REPLACE; 

} 


Known Deviations: None 


VSRM - Character Cell Display EL-00070-05 Page 5-139 

Digital Internal Use Only - For Review Only 29-Jun-1990 


INSERT OR REPLACE GRAPHIC CHARACTER 
Levels: 1-4 

Purpose: To place a graphic character in the display at the 

Active Position. 


Format: implied on receipt of graphic character data 


I Description: This procedure is called on receipt of graphic 

I character data to place the data in the appropriate position in 
1 the display structure. The character code, as well as the values 
I of the Current Rendition, Current Attribute, and the character set 
I indicated by the In Use Table (left side if code <= 7/14, 

I otherwise right side) are stored in the display list. 

I The Active Position is advanced by one column each time this 
I operation is performed until it reaches the Right Margin, or the 
I last column of the Active Line. If the Active Position is within 

I the Scroll Area, it will advance to the Right Margin. If the 
I Active Position is outside the Scroll Area, it will advance to the 
1 last column of the Active Line . 

I If Auto Wrap mode is off, the Active Position will not advance 
I beyond the Right Margin or last column of the Active Line. 

I Additional graphic characters received will overwrite this 
I position. 

I If Auto Wrap Mode is on and the Active Position is within the 
I Vertical Scroll Margins, the Active Position will advance from the 
I Right Margin or last column of the Active Line, to the Left Margin 
I of the next line (causing the display to scroll if necessary) when 
I a graphic character is received and the Last Column Flag is set 
I (see Auto Wrap Mode, DEC STD 70-D for details) . 

I If Auto Wrap Mode is on and the Active Position is outside the 
I Vertical Scroll Margins, the Active Position will advance from the 
I last column of the Active Line, to the first column of the next 
1 line when a graphic character is received and the Last Column Flag 
1 is set (see Auto Wrap Mode, DEC STD 70-D for details) . No 
1 scrolling will occur. 

Notes : 

1. This operation is affected by the setting of 

Insert/Replacement Mode. When this mode is in the reset 
state (Replace) the new data will overwrite existing data 
at the Active Position. When this mode is in the set 
state (Insert) the contents of the active line will be 
shifted right one column starting at the Active Position 
I to accommodate the new data. Data shifted past the Right 
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I Margin within the Scroll Area, or the last column of the 

Active Line outside the Scroll Area is lost. 


State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 
act i ve__po s i t ion 


Algorithm: 


void insert_or_replace_character (parv) 
short int parv [ ] ; 

{ 


column_t x; 

short int line; /* actual line in logical display 
short int margin; /* effective right boundary */ 
line = (active_posit ion .page * lines_per_page) + 
active_position . line; 
if (insert_replacement_mode == INSERT) 

{ 

/* determine right boundary for shifting characters * 
if ( (active_position . column <= right_margin) && 
(active_position . line >= bottom_margin) && 
(active_position . line <= top_margin) && 
(right_margin < end_of_line (line) ) ) 

margin = right_margin; 
else 

margin = end_of_line (line) ; 

/* make room for character to be inserted */ 
for ( x=margin; 

X > active_position . column; 

X-- ) 

strncpy ( display [line] [x] , display [line] [x-1] , 
sizeof (character t) ) ; 


} 


/* put code in the display, strip 8th bit */ 

display [line] [active__position . column] . code = parv[0] & 


*/ 


/ 


0x7F; 


display [line] [ act ive_position . column] .rendition = 
current_rendition; 

display [line] [active_position . column] .attribute = 
current attribute; 


/* write the character set */ 
if (single_shift == NO_SINGLE_SHIFT) 

{ 

if (parv[0] <= 126) 

display [line] [active_position . column] . character_set = 
in_use_tabie . gl ; 

else 
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display [line] [active_position . column] . character_set = 
in_use_table . gr ; 

} 

else if {single_shift == SS2) 

display [line] [active_position . column] . character_set = 
designated_graphic_sets [2] / 
else if (single_shift == SS3) 

display [line] [active_position . column] . character_set = 
designated_graphic_sets [3] ; 

/* advance the active position after entering character */ 
if (active_position . column < margin) 
active_j>osition . column += 1; 
else /* active position is at effective margin */ 
if (auto_wrap_mode = WRAP_ON) 

{ 

if (last_column_f lag) 

{ 

carriage_return 0 / 
line_feed () ; 

last_column_f lag = FALSE; 

} 

else 

last_column_f lag = TRUE; 

} 

} /* end insert_or_replace_character 0 */ 


Known Deviations : None 
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INSERT CHARACTER 


ICH 


Levels: 2-4 

Purpose: Insert empty characters at the Active Position. 


Format : 


CSI Pn @ 

9/11 Pn 4/0 


default Pn: 1 


Description: The ICH control causes empty characters to be 

inserted at the Active Position. A parameter value of zero or one 
causes a single empty character to be inserted. A parameter value 
of n causes n empty characters to be inserted. Data on the Active 
I Line from the Active Column to the Right Margin is shifted forward 
I as in character insertion. Characters shifted beyond the Right 
I Margin are lost . 


Notes : 


I 


I 

I 


1. The extent of the display affected by execution of this 
control is limited to the Active Line within the left and 
right margins . Data which is shifted beyond the Right 
Margin is lost. 

2. If the active position is outside the left or right 
margin, this control is ignored. 


3. The Active Position is not affected by execution of this 
control . 


4. Execution of this control is not affected by the setting 
of Insert /Replacement Mode. 


State Affected: 

di sp 1 ay [ MAX_NUM_L INE S ] [ MAX_NUM_COLUMNS ] 
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Algorithm: 

void insert_character (parv) 

int parv[MAX_NUM_PARAMETERS] ; 

{ 

column_t x; 

short int line; /* actual line in logical display */ 
short int margin; /* effective right boundary */ 
short int n; 

/* */ 

/* ignore if we're outside the scrolling area */ 


if ( (active_position. line >= bottom_margin) && 
(active_position . line <= top_margin) && 
(active_position . column >= left_margin) && 
(active_position . column <= right_margin) ) 

{ 


line = ( act ive_po sit ion .page * lines^er_^age) + 
active_position . line ; 

/* determine right boundary for shifting characters */ 
if (right_margin < end_of_line (line) ) 
margin = right_margin; 
else 

margin = end_of_line (line) ; 

if (parv[0] == 0) n = 1; 
else n = parv[0]; 

if ( (act ive_pos it ion . column + n) > margin) 
n = margin - act ive_position . column + 1; 

/* make room for characters to be inserted */ 
for ( x=margin; 

X > active_position . column + n; 

X — ) 

strncpy ( display [line] [x] , display [line] [x-n] , 
sizeof (character_t) ) ; 
for (x=l; x<=n; x++) 

{ 

display [line] [active_position.column+ (x-1) ] .code = 
EMPTY_CHARACTER; 

} 

} 

} 


Known Deviations: None 
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DELETE CHARACTER DCH 


Levels: IX, 2-4 

Purpose: Delete characters at the Active Position. 


Format: CSI Pn P default Pn: 1 

9/11 Pn 5/0 


Description: The DCH control causes characters to be deleted at 

the Active Position. A parameter value of zero or one causes a 
single character to be deleted. A parameter value of n causes n 
I characters to be deleted. Data on the Active Line between the 
I Active Column and Right Margin is shifted left to close up the 
I deleted character positions, and empty characters are inserted at 
I the Right Margin to accommodate the shift. 

Notes : 

1. The DCH control is part of the Level 1 Editing Extension. 
This extension is required in all new Level 1 
implementations. It is a required function in Level 2. 

I 2. The extent of the display affected by execution of this 

I control is limited to the Active Line within the left and 

1 right margins . 

I 3. If the Active Position is outside the left or right 

I margins, this control is ignored. 

4. The Active Position is not affected by execution of this 
control. 

5. Execution of this control is not affected by the setting 
of Insert /Replacement Mode. 


State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 
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Algorithm: 

void delete_character (parv) 

int parv[MAX_NUM_PARAMETERS] ; 

{ 

column_t x; 

short int line; /* actual line in logical display */ 
short int margin; /* effective right boundary */ 
short int n; 

/* */ 

/* ignore if we're outside left or right margin */ 
if { (active_position . column >= left_margin) && 

(active_position . column <= right_margin) ) 

{ 

line = ( act ivej>o sit ion .page * lines_per_page) + 
active_position . line; 

/* determine right boundary for shifting characters */ 
if (right_margin < end_of_line (line) ) 
margin = right_margin; 
else 

margin = end_of_line (line) ; 

if (parv[0] == 0) n = 1; 
else n = parv[0]; 

if ( (active_position . column + n) > margin) 
n = margin - active_position . column + 1; 

/* make delete characters */ 
for ( x=active_position . column; 

X <= margin-n; 

X++ ) 

strncpy ( display [line] [x] , display [line] [x+n] , 
sizeof (character_t) ) ; 
for (x=l; x<=n; x++) 

{ 

display [line] [margin- (x-1) ] .code = 

EMP T Y_CHARACTER; 

} 

} /* end active position within the left and right margins */ 

} /* end delete character () */ 


Known Deviations: None 
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INSERT LINE IL 


Levels: lx, 2-4 

Purpose: Insert lines of empty characters at the Active Position. 


Format: CSI Pn L default Pn: 1 

9/11 Pn 4/12 


Description: The IL control causes lines of empty characters to 

be inserted at the Active Position. A parameter value of zero or 
one causes a single line to be inserted. A parameter value of n 
causes n lines to be inserted. Data in the display is scrolled 
downward to the Bottom Margin from the active line to accommodate 
I the insertion. Only that portion of the display between the top, 

I bottom, left, and right margins is affected. IL is ignored if the 
1 Active Position is outside the Scroll Area. 

Notes : 

1. The IL control is part of the Level 1 Editing Extension. 
This extension is required in all new Level 1 
implementations. It is a required function in Level 2. 

1 

I 2. The Active Position is set to the Left Margin in the 

I active line after execution of this control. The active 

line does not change. 

State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS ] 
line_rendition [MAX_NUM_LINES] 
a c t i ve_p o s i t i on 
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Algorithm: 

void insert_line (parv) 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

short int n ; 

/* */ 

/* ignore if we're outside the scrolling area */ 
if ( (active_position . line >= bottom_margin) && 
(active_position . line <= top_margin) && 
(active_position . column >= left_margin) && 
(active_position . column <= right_margin) ) 

{ 

if (parv[0] == 0) n = 1; 
else n = parv[0]; 

if ( (active_position. line + n) > bottom_margin) 
n = (bottom_margin - active_position . line) + 1; 
scroll_down (act ive_j>osition . line, n) ; 
active_position . column = left_margin; 

} 

} 

Known Deviations : None 
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DELETE LINE DL 


Levels: lx, 2-4 

Purpose: Delete lines at the Active Position. 


Format: CSI Pn M default Pn: 1 

9/11 Pn 4/13 


Description: The DL control causes lines of characters to be 

deleted at the Active Position. A parameter value of zero or one 
causes a single line to be deleted. A parameter value of n causes 
n lines to be deleted. Data in the display is scrolled upward 
from the Bottom Margin to the active line to accommodate the 
deletion. Only that portion of the display between the top, 
bottom, left, and right margins is affected. DL is ignored if the 
active position is outside the scroll area. 

Notes : 

1. The DL control is part of the Level 1 Editing Extension. 
This extension is required in all new Level 1 
implementations. It is a required function in Level 2. 

2 . The Active Position is set to the Left Margin in the 
active line after execution of this control. The active 
line does not change. 

State Affected: 

display [MAX_NUM_LINES ] [MAX_NUM_COLUMNS ] 
line_rendition [MAX_NUM_LINES ] 
active_position 
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Algorithm: 

void delete_line (parv) 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

short int n; 

/* */ 

/* ignore if we're outside the scrolling area */ 
if ( (active_position . line >= bottom_margin) && 
(active_j30sition . line <= top_margin) && 
(active_position . column >= left_margin) && 
(active_position . column <= right_margin) ) 

{ 

if (parv[0] == 0) n = 1/ 
else n = parv[0]; 

if ( (active_position . line + n) > bottom_margin) 
n = (bottom_margin - active_position . line) + 1; 
scroll_up (active_position . line, n) ; 
active_position . column = left_margin; 

} 

} 

Known Deviations : None 
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INSERT COLUMN 


DECIC 


Level: 4x (Horizontal Scrolling) 

Purpose: Insert columns of empty characters at the Active 

Position . 


Format: CSI Pn ' } default Pn: 1 

9/11 Pn 2/7 7/13 


Description: The DECIC control causes Pn columns to be inserted 

at the active column position. The contents of the display are 
shifted to the right from the active column to the right margin. 
The inserted columns are set to blank with normal rendition. Only 
that portion of the display between the top, bottom, left, and 
right margins is affected. DECIC is ignored if the active 
position is outside the Scroll Area. 


State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 
Algorithm: 

/* routine insert_column (parv) to be supplied */ 
Known Deviations: None 
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DELETE COLUMN DECDC 

Level: 4x (Horizontal Scrolling) 

Purpose: Delete columns at the Active Position 

Format: CSI Pn ' ~ default Pn: 1 

9/11 Pn 2/7 7/14 


Description: The DECDC control causes Pn columns to be deleted at 

the active column position. The contents of the display are 
shifted to the left from the right margin to the active column. 
Columns containing blank characters with normal rendition are 
shifted into the display from the right margin. Only that portion 
of the display between the top, bottom, left, and right margins is 
affected. DECDC is ignored if the active position is outside the 
Scroll Area. 


State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 
Algorithm: 

/* routine delete_column (parv) to be supplied */ 


Known Deviations: None 
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ERASE CHARACTER ECH 


Levels: 2-4 

Purpose: Erase characters at the Active Position. 


Format: CSI Pn X default Pn: 1 

9/11 Pn 5/8 


Description: The ECH control causes the character at the Active 

Position and the next n-1 characters to be erased and their 
attributes set to normal . A parameter value of zero causes a 
single character to be erased. No reformatting of data on the 
line occurs, and the Active Position does not move. 

Notes : 

1 . The extent of the display affected by execution of this 
control is limited to the Active Line. If a parameter 
value is given which is greater than the distance from 
the Active Position to the end of the Active Line, only 
character positions up to the end of the Active Line will 
be erased. This control is not affected by the margins. 

2 . Execution of this control is not affected by the setting 
of Insert/Replacement Mode. 

State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 
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Algorithm: 

void erase_character (parv) 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

column_t x; 

short int line; /* actual line in logical display */ 
short int n; 

/* */ 

line = active_position.page * lines_per_page + 
active_position. line; 
if (parv[0] == 0) n = 1; 
else n = parv[0]; 

if ( (act ive_po sit ion . line + n) > end_of_line (line) ) 
n = (end_of_line (line) - active_position . column) + 1; 
for (x=activej)osition . column; 

X <= active_position . column + (n-1) ; 

X++) 

{ 

display [line] [x] .code = EMPTY_CHARACTER; 

} 

} 

Known Deviations: None 
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ERASE IN LINE EL 


Levels: 1-4 

Purpose: Erase character positions within the Active Line. 


Format: CSI Ps K default Ps: 0 

9/11 Ps 4/11 


Description: The EL control causes a set of adjacent character 

positions in the Active Line to be set to the empty state, that is 
the empty character (imaged as SPACE) , the empty rendition, and 
the empty character attribute. The set of character positions 
affected by this control is determined by the parameter value. An 
omitted parameter or a value of zero (0) cause the control to 
affect character positions from the Active Column to the end of 
the Active Line (inclusive) . A parameter value of one (1) causes 
the control to affect character positions from the beginning of 
the Active Line to the Active Column (inclusive) . A parameter 
value of two (2) causes the control to affect all character 
positions in the Active Line (inclusive) . 

Notes : 

1. The line renditon is not affected by execution of this 
control . 

2. The syntax of the EL control is identical to the 

Selective Erase in Line (DECSEL) control, except that 
DECSEL includes a private parameter specifier ? (3/15) . 

3. This control is not affected by the margins. 


State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 
line rendition [MAX NUM LINES] 
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Algorithm: 

/* 

* erase_in_line 

* both standard and selective erase 
*/ 

void erase_in_line (pare, parv, private) 
short int pare; 

short int parv [MAX_NUM_PARAMETERS] ; 
boolean_t private; 

{ 

column_t x; 

short int line; /* actual line in logical display */ 
short int n; 

/* */ 

if (private) select ive_erase_in_line (pare, parv) ; 
else 
{ 

line = act ive_po sit ion .page * lines^er_page + 
active_position , line; 
if (pare == 0) pare = 1; 
for (n=0; n<parc; n++) 

{ 

switch (parv [n] ) 

{ 

case 0 : 

for (x=active_position . column; 

X <= end_of_line (line) ; x++) 
display [line] [x] .code = EMPTY_CHARACTER; 
break; 
case 1 : 

for (x=l; x<=active_position . column; x++) 
display [line] [x] .code = EMPTY_CHARACTER; 
break; 
case 2 : 

for (x=l; x<=end_of_line (line) ; x++) 

display [line] [x] .code = EMPTY_CHARACTER; 
break; 

} 

} 

} 

} /* end erase in line() */ 


Known Deviations : None 
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ERASE IN DISPLAY ED 


Levels: 1-4 

Purpose: Erase character positions within the display. 


Format: CSI Ps J default Ps: 0 

9/11 Ps 4/10 


Description: The ED control causes a set of adjacent character 

positions (extending across line boundaries) in the display to be 
set to the empty state. That is the empty character (imaged as 
SPACE), the empty rendition, and the empty character attribute. 
The set of character positions affected by this control is 
determined by the parameter value. An omitted parameter or a 
value of zero (0) cause the control to affect character positions 
from the Active Position to the end of the bottom line in the 
display (inclusive) . A parameter value of one (1) causes the 
control to affect character positions from the beginning of the 
first line of the display to the Active Position (inclusive) . A 
parameter value of two (2) causes the control to affect all 
character positions in the display (inclusive) . 

Notes: 

1. The Line Renditions of all lines completely erased (all 
character positions in the line set to the erased state, 
that is, empty characters) as a result of execution of 
this control are set to single-width. 

2. This control affects the entire display and is not 
affected by the setting of the scrolling region or the 
setting of Origin Mode. 

3. The syntax of the ED control is identical to the 

Selective Erase in Display (DECSED) control, except that 
DECSED includes a private parameter specifier ? (3/15) . 


State Affected: 

di sp 1 ay [ MAX_NUM_L INE S ] [ MAX_NUM_COLUMNS ] 
line rendition [MAX NUM LINES] 



VSRM - Character Cell Display EL-00070-05 Page 5-157 

Digital Internal Use Only - For Review Only 29-Jun-1990 


Algorithm: 

/* 

* erase_in_display 

* both standard and selective erase 
*/ 

void erase_in_display (pare, parv, private) 
short int pare; 

short int parv [MAX_NUM_PARAMETERS] ; 
boolean_t private; 

{ 

line_t y; 
column_t x; 

short int base; /* first line(-l) of current page */ 
short int line; /* actual line in logical display */ 
short int n; 

/* */ 

if (private) selective_erase_in_display (pare, parv); 
else 
{ 

base = ( act ive_posit ion .page- 1) * lines_per_page; 
line = base + active^osition . line; 
if (pare == 0) pare = 1; 
for (n=0; n<parc; n++) 

{ 

switch (parv [n] ) 

{ 

case 0: /* erase to end of display */ 

for ( x=active_po sit ion. column ; 

X <= end_of_line (line) ; x++) 
display [line] [x] .code = EMPTY_CHARACTER; 
if (active_j>osition . column = 1) 

line_rendition[line] = SINGLE_WIDTH; 
for (y=line+l; y< (base+lines__per_page) ; y++) 

{ 

for (x=l; x<=end_of_line (y) ; x++) 

{ 

display [y] [x] .code = EMPTY_CHARACTER; 
line_rendition [y] = SINGLE_WIDTH; 

} 

} 

break; 

case 1: /* erase from beginning of display */ 

for (y=l; y< (base+line) ; y++) 

{ 

for (x=l; x<=end_of_line (y) ; x++) 

{ 

display [y] [x] .code = EMPTY_CHARACTER; 
line_rendition[y] = SINGLEJWIDTH; 

} 

} 

for (x=l; x<=active_position . column; x++) 
display [line] [x] .code = EMPTY_CHARACTER; 



VSRM - Character Cell Display EL-00070-05 Page 5-158 

Digital Internal Use Only - For Review Only 29-Jun-1990 


if (active_position . column = end_of_line (line) ) 
line_rendition [line] = SINGLE_WIDTH/ 
break; 

case 2: /* erase entire display */ 

for (y=l; y< (base+lines_per_page) / y++) 

{ 

for (x=l; x<=end_of_line (y) ; x++) 

{ 

display [y] [x] .code = EMPTY_CHARACTER; 
line_rendition[y] = SINGLE_WIDTH/ 

} 

} 

break; 

} 

} 

} /* end not private */ 

} /* end erase_in_display 0 */ 


Known Deviations : None 
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SELECTIVE ERASE IN LINE DECSEL 


Levels: 2x, 3x, 4x (Selective Erase) 

Purpose: Change character positions within the Active Line which 

have the Selectively Erasable attribute to the Space character 

( 2 / 0 ) . 


Format: CSI ? Ps K default Ps: 0 

9/11 3/15 Ps 4/11 


Description: The DECSEL control causes a set of adjacent 

character positions in the Active Line which have the attribute 
"Selectively Erasable" to be changed to the Space character (2/0) . 
The character rendition and attributes associated with each 
position do not change. Characters which have been entered into 
the display with the Selectively Erasable attribute reset (Not 
Selectively Erasable) r as well as empty character positions are 
not affected by this control, and no reformatting of the data will 
occur . 

The set of character positions affected by this control is 
determined by the parameter value . An omitted parameter or a 
value of zero (0) cause the control to affect character positions 
from the Active Column to the end of the Active Line (inclusive) . 

A parameter value of one (1) causes the control to affect 
character positions from the beginning of the Active Line to the 
Active Column (inclusive) . A parameter value of two (2) causes 
the control to affect all character positions in the Active Line 
(inclusive) . 

Notes : 

1. Use of this control permits efficient "clearing" of parts 
of the screen while leaving other parts alone, such as in 
form filling applications. (See Select Character 
Attribute, DECSCA, for a description of how to invoke the 
selectively erasable character attribute) . This 
capability is an extension to Level 2 and so is not 
available in all Level 2 terminals. 

2. This control is only executed if the Level 2 extension 
Selectively Erasable Characters is supported. In Level 1 
operation and in other Level 2 devices it will be 
ignored. 

3. The Line Rendition is not affected by execution of this 
control . 
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4 . The syntax of the DECSEL control is identical to the 

Erase in Line (EL) control, except that DECSEL includes a 
private parameter specifier ? (3/15) . 

5. This control is not affected by the margins. 


State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 
line_rendition [MAX_NUM_LINES] 

Algorithm: 

void select ive_erase_in_line (pare, parv) 
short int pare; 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

column_t x; 

short int line; /* actual line in logical display */ 
short int n; 

/* */ 

line = act ive_position .page * lines__per_page + 
active_position . line; 
if (pare == 0) pare = 1; 
for (n=0; n<parc; n++) 

{ 

switch (parv [n] ) 

{ 

case 0 : 

for (x=active_position . column; 

X <= end_of_line (line) ; x++) 

{ 

if (display [line] [x] . attribute . selective_erase) 
display [line] [x] .code =32; /* Space */ 

} 

break; 
case 1 : 

for (x=l; x<=act ive_pos it i on . column; x++) 

{ 

if (display [line] [x] . attribute . selective_erase) 
display [line] [x] . code = 32; /* Space */ 

} 

break; 
case 2 : 

for (x=l; x<=end_of_line (line) ; x++) 

{ 

if (display [line] [x] . attribute . select ive_erase) 
display [line] [x] . code = 32; /* Space */ 

} 

break; 

} 


} 
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} /* end selective erase_in_line () */ 

Known Deviations : None 
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SELECTIVE ERASE IN DISPLAY DECSED 


Levels: 2x, 3x, 4x (Selective Erase) 

Purpose: Change character positions within the display which have 

the Selectively Erasable attribute to the Space character (2/0) . 


Format: CSI ? Ps J default Ps: 0 

9/11 3/15 Ps 4/10 


Description: The DECSED control causes a set of adjacent 

character positions in the display which have the attribute 
"Selectively Erasable" to be changed to the Space character (2/0). 
The character rendition and attributes associated with each 
position do not change. Characters which have been entered into 
the display with the Selectively Erasable attribute reset (Not 
Selectively Erasable) , as well as empty character positions, are 
not affected by this control, and no reformatting of the data will 
occur . 

The set of character positions affected by this control is 
determined by the parameter value . An omitted parameter or a 
value of zero (0) cause the control to affect character positions 
from the Active Position to the end of the bottom line in the 
display (inclusive) . A parameter value of one (1) causes the 
control to affect character positions from the beginning of the 
first line of the display to the Active Position (inclusive) . A 
parameter value of two (2) causes the control to affect all 
character positions in the display (inclusive) . 

Notes : 

1. Use of this control permits efficient "clearing" of parts 
of the display while leaving other parts alone, such as 
in form filling applications. (See Select Character 
Attribute, DECSCA, for a description of how to invoke the 
selectively erasable character attribute) . 

2. This control is only executed if the Level 2 extension 
Selectively Erasable Characters is supported. In Level 1 
operation and in other Level 2 devices it will be 
ignored. 

3. The Line Renditions of all lines are not affected by 
execution of this control. 

4. This control affects the entire display and is not 
affected by the setting of the scrolling region or the 
setting of Origin Mode. 
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5. The syntax of the DECSED control is identical to the 
Erase in Display (ED) control, except that DECSED 
includes a private parameter specifier ? (3/15) . 


State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 
line rendition [MAX NUM LINES] 


Algorithm: 

void selective_erase_in_display (pare, parv) 
short int pare; 

short int parv [MAX_NUM_PARAMETERS] ; 

{ 

line_t y; 
column_t x; 

short int base; /* first line(-l) of current page */ 
short int line; /* actual line in logical display */ 
short int n; 

/* */ 

base = (active_position .page-1) * lines_per_page; 
line = base + active_position . line; 
if (pare == 0) pare =1; 
for (n=0; n<parc; n++) 

{ 

switch (parv [n] ) 

{ 

case 0: /* erase to end of display */ 

for (x=active_position . column; 

X <= end_of_line (line) ; x++) 

{ 

if (display [line] [x] . attribute . selective_erase) 
display [line] [x] . code = 32; /* Space */ 

} 

if (active_position . column = 1) 

line_rendit ion [line] = SINGLE_WIDTH; 
for (y=line+l; y< (base+lines_per_j5age) ; y++) 

{ 

for (x=l; x<=end_of_line (y) ; x++) 

{ 

if (display [y] [x] . attribute . selective_erase) 
display [y] [x] . code = 32; /* Space */ 

} 

} 

break; 

case 1: /* erase from beginning of display */ 

for (y=l; y< (base+line) ; y++) 
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{ 

for (x=l; x<=end_of_line (y) ; x++) 

{ 

if (display [y] [x] . attribute . select ive_erase) 
display [y] [x] .code = 32; /* Space */ 

} 

} 

for (x=l; x<=act ive^os it i on . column; x++) 

{ 

if (display [line] [x] . attribute . select ive_erase) 
display [line] [x] .code = 32; /* Space */ 

} 

if (active_jposition . column = end_of_line (line) ) 
line_rendit ion [line] = SINGLEJWIDTH; 
break; 

case 2: /* erase entire display */ 

for (y=l; y< (base+lines_per_page) ; y++) 

{ 

for (x=l; x<=end_of_line (y) ; x++) 

{ 

if (display [y] [x] . attribute . selective_erase) 
display [y] [x] .code = 32; /* Space */ 

} 

} 

break; 

} 

} 

} /* end select ive_erase_in_display 0 */ 


Known Deviations : None 
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5.11.1 Character Attributes 

Each character cell in the display may also have logical 
(non-visual) attribute associated with it, which affect its 
characteristics when processed or retransmitted by the terminal. 
These attributes can be combined in any manner for each character 
position independently. The architecture requires that each 
character attribute and every character attribute combination to 
have effect individually and independently from every other 
character attribute and character rendition (see previous 
section) . Character attributes apply to all graphic characters 
codes (2/1 to 7/14 inclusive, and 10/1 to 15/14 inclusive) as well 
as to the Space character (2/0) . 


5.11.1.1 Normal Character Attribute - The Normal character 
attribute defines the non-visible attributes in the physical 
display in its "natural" state, that is, where the character 
behaves with no special non-visible attributes. 


5.11.1.2 Selectively Erasable Character Attribute - One logical 
attribute may be applied to characters as a Level 2 or higher 
extension. This attribute is referred to as "Selectively Erasable 
Character" . When this extension is provided, the terminal will 
recognize two forms of the commands Erase_In_Line and 
Erase_In_Display : one in which all characters in the given extent 

are erased, regardless of their logical attributes, and another in 
which all character in the given extent which have been assigned 
the Selectively Erasable Character attribute are turned into Space 
characters (2/0). (See the Select Character Attribute, Erase In 
Line, and Erase In Display control functions for a complete 
description of this feature) . 



VSRM - Character Cell Display EL-00070-05 Page 5-166 

Digital Internal Use Only - For Review Only 29-Jun-1990 


SELECT CHARACTER ATTRIBUTE DECSCA 

Levels: 2x, 3x, 4x (Selective Erase) 

Purpose: Designate the character attribute (s) to be applied to 

all subsequent characters entered into the display. 


Format: CSI Ps ; . . . ; Ps " q default Ps: 0 

9/11 Ps / ... ; Ps 2/2 7/1 


Description: The DECSCA control selects the character attribute 

(logical attribute) to be applied to all subsequent characters 
entered into the display. The parameter values indicate the 
combination of attributes to be selected as indicated in the 
following table: 


Parameter Rendition 

0 Attributes off 

1 Not Selectively Erasable 

(attribute on) 

2 Selectively Erasable 


Notes : 

1. Character attribute parameter values are assigned in 
pairs. The lower (odd) value sets the attribute to the 
on state and the higher (even) value resets the attribute 
to the off state (same as normal or when all attributes 
are turned off (value 0) . 

2. All other parameter values will be ignored. 

3. Attributes may be selected in any combination, and will 
be rendered appropriately. Selecting additional 
attributes does not affect the setting of previously 
selected attributes (newly selected attributes will be 
combined with previously selected attributes) unless all 
attributes are turned off (parameter value zero (0) ) . 

4. In no way does the selection of attributes affect the 
rendition (SGR) or attributes (DECSCA) of characters 
already entered into the display. 

5. This control is ignored unless the Level 2 or higher 
extension for Selectively Erasable Characters is 
supported. The Selectively Erasable Character attribute 
affects the execution of the controls Selective Erase In 
Line (DECSEL) and Selective Erase In Display (DECSED) . 
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State Affected: 

display [MAX_NUM_LINES] [MAX_NUM_COLUMNS] 


Algorithm: 

void select_character_attribute (pare, parv) 
short int pare; 

short int parv [MAX_NUM_PARAIyIETERS] / 

{ 

short int n; 

/* */ 

if (conf ormance_level >= 2) 

{ 

if (pare == 0) pare = 1; 
for (n=0/ n<parc; n++) 

{ 

switch (parv [n] ) 

{ 

case 0 : 

current_attribute . selective_erase = TRUE; 
break; 
case 1 : 

current_attribute . selective_erase = FALSE; 
break; 
case 2 : 

current_attribute . selective_erase = TRUE; 
break; 

} 

} 

} 

} /* end select character attribute () */ 


Known Deviations : None 
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5.12 OLTP FEATURES 

This subsection describes features defined at Level 4 to improve 
performance for On Line Transaction Processing (OLTP) . These 
include Rectangular Area Operations, Data Integrity Checking, and 
Text Macros . 


5.12.1 Rectangular Area Operations 

This subsection describes the following functions used to edit 
data, or control editing of rectangular areas in the Logical 
Display . 


DECCRA - Copy Rectangular Area 

DECFRA - Fill Rectangular Area 

DECERA - Erase Rectangular Area 

DECSERA - Selective Erase Rectangular Area 

DECCARA - Change Att In Rectangular Area 

DECRARA - Reverse Attributes Rectangular Area 

DECSACE - Select Attribute Change Extent 
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COPY RECTANGULAR AREA DECCRA 

Level : 4 

Purpose : To copy a rectangular array of characters from one part 

of a logical display page to another. 


Format: CSI Pts; Pis; Pbs; Prs; Pps; Ptd; Pld; Ppd $ v 

9/11 Pts; Pis; Pbs; Prs; Pps; Ptd; Pld; Ppd 2/4 7/6 


Description: When this control is received, the terminal copies 

the character values and attributes in the specified rectangular 
area of character positions defined by Pts, Pis, Pbs, and Prs on 
the specified page Pps, to the area specified by the coordinate 
Ptd, Pld on the specified page Ppd. Pts, Pbs, and Ptd are line 
numbers. Pis, Prs, and Pld are column numbers. Pps and Ppd are 
page numbers. The character positions (Pts, Pis) and (Pbs, Prs) 
define the rectangular area that is to be copied from page Pps. 

The coordinates of the rectangular area are affected by the 
setting of Origin Mode. This control is not otherwise affected by 
the margins . 

If the rectangular area contains both single and double width 
lines, the area copied FROM may not appear rectangular on the 
display. For example if Pl=5 and Pr=10, then characters 5 through 
10 from all lines within the rectangular area will be copied 
whether they are single width or double width characters. Text 
copied to the destination area take on the line attributes of that 
area . 

Pts must be less or equal to Pbs, and Pis must be less than or 
equal to Prs, otherwise the entire control function is ignored. 
Default values are Pts = 1, Pis = 1, Pbs = last-line-of-page, Prs 
= last-column-of-page, Pps = 1, Ptd = 1, Pld = 1, and Ppd =1. If 
a value exceeds the width or height of the active page, it is 
treated as the width or height of the active page. If a page 
value exceeds the number of pages available in the current Page 
Configuration, it is treated as the last page in the current 
configuration. 

If the destination rectangle specified is partially off of the 
Page, clipping of information will occur; only information which 
will appear in valid character positions in the page will be 
copied. 

The Active Position does not change. 
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FILL RECTANGULAR AREA DECFRA 


Level : 4 

Purpose: To fill a group of adjacent character positions defined 

by a rectangular area. 


Format: CSI Pch ; Pt ; PI ; Pb ; Pr $ x 

9/11 Pch ; Pt / PI ; Pb / Pr 2/4 7/8 


Description: When this control is received, the terminal fills 

the rectangular area of character positions defined by Pt, Pi, Pb, 
and Pr, replacing both the character and the rendition present in 
those character positions with the character defined by the 
decimal value of Pch and the current renditions set through the 
SGR command. 

The Pch parameter may be a decimal value from 32 to 126, or from 
160 to 255. The decimal value refers to the character in the 
current GL and GR "in-use" character table, which is used to fill 
the specified rectangular area. If the value of Pch is not in the 
above range, the command is ignored. 

Pt and Pb are line numbers, and PI and Pr are column numbers. The 
character positions (Pt, PI) and (Pb, Pr) define the rectangular 
area . 

The coordinates of the rectangular area are affected by the 
setting of Origin Mode. This control is not otherwise affected by 
the margins . 

Pt must be less or equal to Pb, and PI must be less than or equal 
to Pr, otherwise the entire control function is ignored. Default 
values are Pch =32, Pt = 1, Pb = last-line-of-page, PI = 1, and 
Pr = last-column-of-page . If a value exceeds the width or height 
of the active page, it is treated as the width or height of the 
active page. 

Notes on DECFRA: 

1 . If the rectangular area contains both single and double 
width lines, the area affected may not appear rectangular 
on the display. For example if Pl=5 and Pr=10, then all 
lines within the rectangular area, whether single or 
double width, will have character positions 5 through 10 
affected. 

DECFRA does not change any line attributes . Double 
height or double width characters will be filled into 
positions on lines containing those attributes. The 
Active Position does not move. 


2 . 


VSRM - Character Cell Display EL-00070-05 Page 5-171 

Digital Internal Use Only - For Review Only 29-Jun-1990 


ERASE RECTANGULAR AREA DECERA 

Level : 4 

Purpose: To erase a group of adjacent characters defined by a 

rectangular area. 

Format: CSI Pt ; PI ; Pb ; Pr $ z 

9/11 Pt ; PI ; Pb ; Pr 2/4 7/10 


Description: When this control is received, the terminal erases 

the rectangular area of character positions defined by Pt, PI, Pb, 
and Pr, clearing all character attributes. Line attributes are 
not changed. When an area is erased, all characters are replaced 
with the Space character (2/0) . Any unoccupied character 
positions remain unoccupied. The Active Position does not move. 

Pt and Pb are line numbers, and PI and Pr are column numbers. The 
character positions (Pt, Pi) and (Pb, Pr) define the rectangular 
area. 

The coordinates of the rectangular area are affected by the 
setting of Origin Mode. This control is not otherwise affected by 
the margins . 

Pt must be less or equal to Pb, and PI must be less than or equal 
to Pr, otherwise the entire control function is ignored. Default 
values are Pt = 1, Pb = last-line-of-page, PI = 1, and Pr = 
last-column-of-page . If a value exceeds the width or height of 
the active page, it is treated as the width or height of the 
active page. 

Notes on DECERA: 

1. If the rectangular area contains both single and double 
width lines, the area affected may not appear rectangular 
on the display. For example if Pl=5 and Pr=10, then all 
lines within the rectangular area, whether single or 
double width, will have character positions 5 through 10 
affected. 
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SELECTIVE ERASE RECTANGULAR AREA DECSERA 

Level : 4 

Purpose: To erase a group of unprotected characters defined by a 

rectangular area. 


Format: CSI Pt / PI ; Pb ; Pr $ { 

9/11 Pt / PI ; Pb / Pr 2/4 7/11 


Description: This control function erases unprotected characters 

within the rectangular area of character positions defined by Pt, 
PI, Pb, and Pr. Unprotected characters are those with the 
"Selective Erase" character attribute (see DECSCA) . When a 
character is erased, it is replaced with the Space character 
(2/0). Unoccupied character positions are not affected. This 
sequence does not change or clear any video character attributes 
(SGR or DECSCA) , video line attributes, or the selection 
attribute. The active position does not move. 

Pt and Pb are line numbers, and PI and Pr are column numbers. The 
character positions (Pt, PI) and (Pb, Pr) define the rectangular 
area . 

The coordinates of the rectangular area are affected by the 
setting of Origin Mode. This control is not otherwise affected by 
the margins . 

Pt must be less or equal to Pb, and PI must be less than or equal 
to Pr, otherwise the entire control function is ignored. Default 
values are Pt = 1, Pb = last-line-of-page, PI = 1, and Pr = 
last-column-of-page . If a value exceeds the width or height of 
the active page, it is treated as the width or height of the 
active page. 

Notes on DECSERA: 

1. If the rectangular area contains both single and double 
width lines, the area affected may not appear rectangular 
on the display. For example if Pl=5 and Pr=10, then all 
lines within the rectangular area, whether single or 
double width, will have character positions 5 through 10 
affected. 


VSKM - Character Cell Display EL-00070-05 Page 5-173 

Digital Internal Use Only - For Review Only 29-Jun-1990 


CHANGE ATTRIBUTES RECTANGULAR AREA DECCARA 

Level : 4 

Purpose: To change the character rendition of a group of adjacent 

characters without having to re-write them. 

Format: CSI Pt ; Pi ; Pb / Pr ; Psl ; Ps2...Psn $ r 

9/11 Pt / PI ; Pb / Pr ; Psl ; Ps2...Psn 2/4 7/2 


Description: This sequence changes the video attributes (bold, 

blink, underline, and reverse) for all of the character positions 
in a rectangular area without altering any characters in those 
positions. The active position does not move. 

The area of the page which is affected is indicated by the first 4 
parameters. Pt and Pb are line numbers; Pi and Pr are column 
numbers. The character positions (Pt, PI) and (Pb, Pr) define the 
top-left and bottom-right corners of the rectangular area. Pt 
must be less than or equal to Pb, and PI must be less than or 
equal to Pr. Default values are Pt = 1, Pb = last-line-of-page, 

PI = 1, and Pr = last-column-of-page . If a value exceeds the 
width or height of the active page, it is treated as the width or 
height of the active page. 

The coordinates of the rectangular area are affected by the 
current setting of Origin Mode. This control is not otherwise 
affected by the margins. 

The character positions affected depend on the current setting of 
DECSACE (STREAM or RECTANGLE). See DECSACE for details. 

The video attribute (s) that the character positions are set to is 
indicated by one or more subsequent selective parameters . These 
parameters correspond to the parameters of the Set Graphic 
Rendition control function (SGR) : 


Parameter Parameter Meaning 


0 Attributes off (normal intensity, 
positive image, not underlined, 
not blinking) 

1 Bold or increase intensity 

4 Underscore 

5 Blink 

7 Negative (reverse) image 

22 Normal intensity 

24 Not underlined 

25 Not blinking 

27 Positive image 
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All other parameter values shall be ignored unless they are part 
of a well defined extension to the architecture (such as Color 
Text) . When multiple parameters are used, they are cumulative, as 
if several DECCARA control functions were received and executed in 
sequence . 

The default for the video attribute parameters, if no valid 
subsequent parameter is received, is 0, which will clear all video 
attributes in the specified area. This command does not change 
the current graphic rendition. 

Notes on DECCARA: 

1. If the rectangular area contains both single and double 
width lines, the area affected may not appear rectangular 
on the display. For example if Pl=5 and Pr=10, then all 
lines within the rectangular area, whether single or 
double width, will have character positions 5 through 10 
affected. 
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REVERSE ATTRIBUTES RECTANGULAR AREA DECRARA 

Level : 4 

Purpose: To reverse character attributes of a group of adjacent 

characters without having to re-write them. 

Format: CSI Pt ; PI ; Pb ; Pr ; Psl ; Ps2. . .Psn $ t 

9/11 Pt ; PI ; Pb ; Pr ; Psl ; Ps2...Psn 2/4 7/4 


Description: This sequence reverses one or more video attributes 

(bold, blink, underline, reverse) for all of the character 
positions in a rectangular area without altering any characters in 
those positions. The active position does not move. To reverse 
the attribute bit within the specified range means to set the 
specified attribute bits if it was not previously set, and reset 
the bit (s) if it was already set. 

The area of the page which is affected is indicated by the first 4 
parameters. Pt and Pb are line numbers; PI and Pr are column 
numbers. The character positions (Pt, PI) and (Pb, Pr) define the 
top-left and bottom-right corners of the rectangular area. 

The coordinates of the rectangular area are affected by the 
setting of Origin Mode. This control is not otherwise affected by 
the margins . 

The character positions affected depend on the current setting of 
DECSACE (STREAM or RECTANGLE) . See DECSACE for more details. 

Pt must be less or equal to Pb, and Pi must be less than or equal 
to Pr, otherwise the entire control function is ignored. Default 
values are Pt = 1, Pb = last-line-of-page. Pi = 1, and Pr = 
last-column-of-page . If a value exceeds the width or height of 
the active page, it is treated as the width or height of the 
active page . 

The video attribute (s) to be reversed are in the affected area are 
indicated by one or more subsequent parameters . These parameters 
are similar to the parameters of the Set Graphic Rendition control 
function (SGR) : 

Parameter Parameter Meaning 

0 Reverse all attributes 

1 Reverse bold attribute 

4 Reverse underscore attribute 

5 Reverse blinking attribute 

7 Reverse negative (reverse) image attribute 


All other parameter values shall be ignored unless they are part 
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of a well defined extension to the architecture. Note if the 
Color Text Extension is present, the color text SGR values are 
ignored since the "reverse" of a color is not defined by the 
extension . 

When multiple parameters are used, they are cumulative, as if 
several DECRARA control functions were received and executed in 
sequence . 

There is no default for the video attribute parameters, if no 
valid subsequent parameter is received, the command is ignored. 

This sequence does not change the current graphic rendition (see 
SGR) . 

Notes on DECRARA: 

1. If the rectangular area contains both single and double 
width lines, the area affected may not appear rectangular 
on the display. For example if Pl=5 and Pr=10, then all 
lines within the rectangular area, whether single or 
double width, will have character positions 5 through 10 
affected. 
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SELECT ATTRIBUTE CHANGE EXTENT DECSACE 

Level : 4 

Purpose: To specify what character positions are affected by 

DECCARA and DECRARA control functions (STREAM or RECTANGLE) 


Format: CSI Ps * x 

9/11 Ps 2/10 7/8 

Ps = 0 stream of character positions are affected (default) 

Ps = 1 stream of character positions are affected 

Ps = 2 rectangular area of character positions are affected 


Description: This control function is used to specify what 

character positions are affected by the DECCARA and DECRARA 
control functions . 

When Ps = 0 or 1, DECCARA and DECRARA affects the stream of 
character positions beginning with the first character position 
specified in the command, and ending with the second character 
position specified. The following diagram shows an example of 
these character positions. The two asterisks represent the 
character positions specified in the DECCARA or DECRARA control 
function. The "U"'s represent unoccupied character positions. 
These unoccupied positions are not affected by DECCARA or DECRARA 
when in this mode. 

+ + 

I I 

I *##############1 

!########UUUUUUUUU| PS = 0 

!#################! 

I###########* I 

I I 

+ + 


When Ps = 2 DECCARA and DECRARA affects all character positions 
within a rectangular area, the top-left and bottom right corners 
of which are specified in the control function. The following 
diagram shows an example of these character positions. The two 
asterisks represent the character positions specified in the 
DECCARA or DECRARA control function. The "U"'s represent 
unoccupied character positions. When DECCARA or DECRARA is 
executed, these character positions are changed to blanks and are 
affected. 
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*######### 

##########UUUUU 

########## 

#########* 


Ps = 2 


In both cases the specified character positions (marked by 
asterisks) are also affected. 
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5.12.2 Data Integrity 

The data integrity features described here are application 
functions intended to improve the reliability of OLTP 
applications. They are not a substitute for error free 
communications as might be provided by an error correcting 
protocol . 


REQUEST CHECKSUM OF RECTANGULAR AREA DECRQCRA 


Level : 4 

Purpose : To cause the terminal to compute and report the checksum 

of a rectangular area, allowing applications to insure it has not 
been changed. 


Format: CSI Pid ; Pp ; Pt ; PI ; Pb ; Pr * y 

9/11 Pid ; Pp ; Pt ; PI ; Pb ; Pr 2/10 7/9 


Description: Upon receipt of a DECRQCRA by the device, a checksum 

of the indicated rectangular area of the indicated page will be 
generated and reported to the host in a Checksum Report (DECCKSR) . 

Pid is an arbitrary numeric label provided by the application to 
identify the checksum request. It will be provided in the DECCKSR 
response from the device. This label serves to differentiate 
between multiple checksum reports if necessary. 

Pp is the page number where the rectangular area of interest is 
located. If Pp is 0 or omitted, subsequent parameters are ignored 
and a checksum for all page memory will be reported. If Pp is 
higher than the total number of pages available in the device, the 
highest numbered page is used. 

The final four parameters indicate the top, left (Pt, PI) and 
bottom, right (Pb, Pr) coordintate of the rectangular area on page 
Pp of which the checksum is to be calculated. The coordinates of 
the rectangular area are affected by the setting of Origin Mode 
(DECOM) . Pt must be less than or equal to Pb, and PI must be less 
than or equal to Pr or the sequence is ignored. 

Default values are: Pt = 1; Pb = last-line-of-page; PI = 1; and 
Pr = last-column-of-page . If the final four parameters are 
unspecified, a checksum of page Pp is generated. 
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MEMORY CHECKSUM DEVICE STATUS REPORT DSR 


Level : 4 

Purpose: To request a checksum of the current text macro 

definitions, allowing the host to insure they have not been 
changed . 


Format: CSI ? 6 

9/11 3/15 3/6 


3 ; Pid n 

3/3 / Pid 6/14 


Description: This request causes a Checksum Report (DECCKSR) to 

be issued reporting the checksum of current text macro 
definitions . 

Pid is an optional numeric parameter which provides a label to 
identify the checksum request. It will be provided in the DECCKSR 
response from the terminal. This label serves to differentiate 
between multiple checksum reports if necessary. 
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CHECKSUM REPORT DECCKSR 


Level : 4 

Purpose: To report a requested checksum. 


Format: DCS Pn ! ~ D...D ST 

9/0 Pn 3/2 7/14 D...D 9/12 


Description: DECCKSR is issued in response to a Request Checksum 

of Rectangular Area (DECRQCRA) or a Device Status Report (DSR) 
with a parameter value of ?63 indicating a request for a checksum 
of the macro definitions. 

The numeric parameter of the DECCKSR control string is a numeric 
label for the checksum report specified in the DECRQCRA or DSR 
control function. This label serves to differentiate between 
multiple checksum reports if necessary. 

The data of the control string consists of four hexadecimal digits 
(3/0 through 3/9 and 4/1 through 4/6) indicating the checksum. 
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5.12.3 Macros 


DEFINE MACRO DECDMAC 


Level : 4 

Purpose: To define a string of characters as a text macro, 

allowing the host to shorten subsequent transmissions. 


Format: DCS Pid ; Pdt ; Pen ! z D. . .D ST 

9/0 Pid ; Pdt ; Pen 2/1 7/10 D. . .D 9/12 

Where 

Pid is the macro ID number: 0-63. 

Pdt is the delete control: 

0 delete only a macro with the same ID number 
(if one exists) before defining this macro. 

1 delete all macro definitions before defining 
this macro. 

Pen is the macro encoding: 

0 text (ASCII) encoding. 

1 hex pair encoding. 


Description: This control string defines a macro consisting of 

ANSI commands. Once defined, a macro can be invoked using DECINVM 
to cause the macro's definition to be processed by the terminal as 
if received from the host. 

Omitted parameters are defaulted to zero. Pid must be a number 
between 0 and 63; Pdt 0 or 1/ and Pen 0 or 1; otherwise the 
control will be ignored. 

The data of the control string is the series of text and ANSI 
commands which are performed when the macro is invoked. 

Macros can invoke other macros with up to 16 levels of nesting, 
but cannot invoke themselves recursively. Macro definitions 
cannot be nested. That is, a DECDMAC cannot be included as part 
of a macro definition. 

When text encoding is used (Pen = 0) , the macro consists of the 
graphic characters appearing in the control string. Only 
characters from 2/0 through 7/14 and 10/00 through 15/15 may be 
included in a macro using this encoding method. 

When hex pair encoding is used (Pen = 1) , each pair of characters 
in the definition represents the hex value of a single ASCII 
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character which will be stored in the definition of the macro. If 
a non-hex pair is encountered that is not a valid repeat sequence, 
the entire macro definition is ignored. 

A Repeat Introducer (!) is defined to allow a string of hex pairs 
to be repeated in the definition any number of times. Repeat 
sequences are imbedded within the text of the macro definition. 

If a non-hex character is encountered in the repeat string, the 
entire macro definition is ignored. 

The format is: 

! Pn ; D . . . D ; 

Where 

! is the repeat introducer 

Pn is a numeric parameter which specifies the number 
of times to repeat the sequence. If Pn is not 
specified, the sequence is inserted into the 
definition once. 

D...D is the sequence to repeat within the definition, 

Pn times. 

; A semicolon separates the repeat count from the 

sequence of hex pairs . Another semicolon terminates 
the sequence . 


If any non parameter characters are encountered before the first 
semicolon, the entire macro definition is ignored. If a string 
terminator is encountered before the final semicolon, the repeat 
string is terminated normally. 

6k bytes of RAM is available for storage of macro definitions. 

Any macro definitions which cannot fit in the remaining macro 
storage space are ignored. 

All macro definitions are cleared on receipt of a Reset to Initial 
State (RIS) or Secure Reset (DECSR) . Soft Terminal Reset (DECSTR) 
has no effect on stored macro definitions. 

Note that characters from 0/8 through 0/13 can be included to 
format the device control string, but are not part of the macro 
definition . 
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INVOKE MACRO DECINVM 


Level : 4 

Purpose: To invoke a previously defined macro definition. 


Format: CSI Pid * z 

9/11 Pid 2/10 7/10 


Description: Causes the specified macro to be invoked. The macro 

must have been previously defined using DECDMAC. The terminal 
substitutes the DECINVM sequence with the contents of the macro 
definition, and executes the substituted text. 

Pid is the macro id number. If a macro is not found with the 
specified id, the command is ignored. 

The current state of the machine is not saved or restored when 
macros are invoked. Any functions executed by a macro invocation 
are still in effect when the macro invocation finishes. 

If the terminal is in Printer Controller mode, the macro is not 
expanded by the terminal. The command to invoke the macro is 
passed on to the printer, to be expanded by the printer' s text 
macro facility. 
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MACRO SPACE REPORT DECMSR 

Level : 4 

Purpose: To report the space remaining for macro definitions in 

response to DSR request. 

Format: CSI Pn * { 

9/11 Pn 2/10 7/11 


Description: DECMSR is reported in response to a Device Status 

Report (DSR) with a private selectable parameter ?62, specifying a 
request to report the available space for macro definitions. 

The numeric parameter specifies the number of bytes available for 
macro definitions divided by 16 (rounded down) . 
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5.13 SAVING AND RESTORING TERMINAL STATE 
5.13.1 Cursor Save Buffer 

A conforming device shall provide a means of saving and restoring 
on command the value of the Active Position, as well as certain of 
the terminal states . The state which must be saved in Level 1 
operation includes the Current Rendition value (determined by the 
most recent occurrence of Select_Graphic_Rendition) , the current 
value of Origin Mode, the character sets designated to GO, Gl, G2, 
and G3, and the character set most recently invoked into the left 
hand side (GL) of the In Use Table. 

In Level 2 operation, all of this state must also be saved, as 
well as the character set most recently invoked into the right 
hand side (GR) of the In Use Table. If the Level 2 extension 
Selectively Erasable Characters is supported, the Current 
Attribute value (determined by the most recent occurrence of 
Select_Character_Attribute) must be saved. If the ANSI Color Text 
Extension is supported, the current foreground and background text 
writing colors are saved as part of the Current Rendition. 

Level 3 and 4 require the same information as Level 2 . 
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SAVE CURSOR DEC SC 


Levels: 1-4 

Purpose: Saves the Active Position and other selective state 

information . 


Format : ESC 7 

1/11 3/7 


Description: In Level 1 operation, the DECSC control provides a 

means of storing the values of the Active Position, the Current 
Rendition, Origin Mode, the currently designated GO, Gl, G2, and 
G3 sets, and the currently invoked GL set. 

In Level 2 or higher it also stores the currently invoked GR set. 
The Current Attribute value is also saved if the Level 2 extension 
for Selectively Erasable Characters is supported. These values 
can later be restored using the DECRC control. 

Notes : 

1 . Only one level of storage is provided by this control . 
Each additional execution of this control will cause 
previously stored values to be lost. 

2. The values of the specified state information (see above) 
are not affected by the execution of this control. 

3. On initialization or reset the values of the save buffer 
are cleared to the following state: 

position . line = 1; 

position . column = 1; 

position .page = 1; 

rendition .bold = FALSE; 

rendition .underscore = FALSE; 

rendition. blink = FALSE; 

rendition . reverse = FALSE; 

attribute . select ive_erase = FALSE; 

origin_mode = ABSOLUTE; 

left = in_use_table . gl; 

right = in_use_table.gr 

gO = designated_graphic_sets [0] ; 

gl = designated_graphic_sets [1] ; 

g2 = designated_graphic_sets [2 ] ; 

g3 = designated_graphic_sets [3] ; 

4 . Execution of Soft Terminal Reset (DECSTR) also causes the 
Save Buffer to be set to the default values as given 
above . 
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State Affected: 

save buffer t cursor save buffer; 


Algorithm: 

void save_cursor 0 

{ 

cursor_save_buffer .position . line = 
active_position . line; 
cursor_save_buffer .position. column = 
active_position . column; 
cursor_save_buf f er . position . page = 
active_position . page ; 
cursor_save_buf fer . rendition .bold = 
current_rendit ion . bold; 
cursor_save_buf fer . rendition . underscore = 
current_rendition . underscore; 
cursor_save_buf fer . rendition .blink = 
current_rendition .blink; 
cursor_save_buf f er . rendition . reverse = 
current_rendition . reverse; 
cursor_save_buf fer . origin_mode = origin_mode; 
cursor_save_buf fer . left = in_use_table . gl; 
cursor_save_buf fer . gO = designated_graphic_sets [0] ; 
cursor_save_buf fer . gl = designated_graphic_sets [1] ; 
cursor_save_buf fer . g2 = designated_graphic_sets [2 ] ; 
cursor_save_buf fer . g3 = designated_graphic_sets [3] ; 
if (conf ormance_level >= LEVEL_2) 

{ 

cursor_save_buf f er . right = in_use_table . gr ; 
cursor_save_buf f er . attribute . selective_erase = 

current_attribute . select ive_erase; 

} 

} /* end save cursor */ 


Known Deviations : None 
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RESTORE CURSOR DECRC 


Levels: 1-4 

Purpose: Restores the previously saved values of the Active 

Position and other selective state information. 


Format : ESC 8 

1/11 3/8 


Description: In Level 1 operation, the DECRC control provides a 

means of restoring the values of the Active Position, the Current 
Rendition, Origin Mode, the currently designated GO, Gl, G2, and 
G3 sets, and the currently invoked GL set. 

In Level 2 or higher it also restores the currently invoked GR 
set. The Current Attribute value is also saved if the Level 2 
extension for Selectively Erasable Characters is supported. These 
values are the ones which were previously stored using the Save 
Cursor (DECSC) control function. 

Notes : 

1. The values of the specified state information (see above) 
at the time this control is received by the terminal are 
lost . 

2. The values stored in the Cursor Save Buffer are not 
affected by execution of this control. 

3. If the restored cursor position lies outside of the 
scrolling region, and the restored value of Origin Mode 
is set, the Active Position will be moved to the closest 
position within the scrolling region. That is, if the 
restored cursor position is above the Top Margin, the 
Active Position will be set to the Top Margin, and if the 
restored position is below the Bottom Margin, the Active 
Position will be set to the Bottom Margin. In either 
case, the Active Column will not change, but will remain 
as the stored column value. For example: the Active 
Position is at line 5, column 5 when the cursor is saved, 
and Origin Mode is set; the scrolling region is 
subsequently changed to 10,15; when the cursor is 
restored, the Active Position will be moved to line 10, 
column 5, to insure that it will lie inside the scrolling 
region. This reason for this recovery is to guarantee 
that the Active Position will always be within the bounds 
of the scrolling region, and will never have a negative 
value . 
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State Affected: 

active_position 

current_rendition 

origin_mode 

in_use_table 

designated_graphic_sets [ 4 ] 
current attribute 


Algorithm: 

void restore_cursor 0 

{ 

I short int base; /* first line(-l) of page */ 

I if (cursor_save_buffer. position. page > number_of_pages) 

I active_posit ion .page = number_of_pages; 

I else active_position.page = cursor_save_buffer. posit ion. page; 

I base = (active^osition .page-1) * lines_per_page; 

I if (cursor_save_buffer .position . column > 

I end_of_line (active_position . line + base)) 

I active_position . column = end_of_line {active_position . line + 

1 base) ; 

I else 

I act ive_pos it ion . column = cursor_save_buffer .position . column; 
active_position . line = cursor_save_buffer .position . line; 

current_rendit ion .bold = 

cursor_save_buf fer . rendition .bold; 
current_rendition . underscore = 

cursor_save_buf fer . rendition . underscore; 
current_rendit ion .blink = 

cursor_save_buf fer . rendition .blink; 
current_rendition . reverse = 

cursor_save_buf fer . rendition. reverse; 

origin_mode = cursor_save_buf fer . origin_mode; 
if (origin_mode == DISPLACED) 

{ 

if (active_j>osition . line < top_margin) 
act ive_posit ion . line = top_margin; 
if (active_j50sition . line > bottom_margin) 
active_position . line = bottom_margin; 
i if (active_position . column < left_margin) 

I active jiosition . column = left_margin; 

1 if (active_position . column > right_margin) 

1 active_position . column = right_margin; 

} 

in_use_table . gl = cursor_save_buffer . left; 
designated_graphic_sets [0] = cursor_save_buffer .gO; 
designated_graphic_sets [1] = cursor_save_buffer . gl ; 
designated_graphic_sets [2 ] = cursor_save_buf f er . g2 ; 



VSRM - Character Cell Display EL-00070-05 Page 5-191 

Digital Internal Use Only - For Review Only 29-Jun-1990 


designated_graphic_sets [3] = cursor_save_buffer ,g3/ 

if (conf ormance_level >= LEVEL_2) 

{ 

in_use_t able . gr = cursor_save_buf f er . right ; 
if (level_2_extensions [SELECTIVE_ERASE]==TRUE) 
current_attribute . selective_erase = 

cursor_save_buf fer . attribute . selective_erase; 

} 

} 


Known Deviations : 

In the VTIOO, VTlOl, VT102, VT125, VT131, and VT132, if the 
restored cursor position lies outside of the scrolling region, and 
the restored value of Origin Mode is set, the Active Position will 
not be moved into the scrolling region, and an illegal (e.g., 
negative) cursor position value may result. 


5.13.2 Terminal State Interrogation 

Terminal State Interrogation (TSI) allows a host computer to query 
most of the settable state in the terminal. Terminal state is 
divided into three general catagories based on the ANSI syntax 
used to control it: (1) modes controlled by 

set ^mode/reset ^mode; (2) selections and settings such as current 

graphic rendition, and scroll margins. (3) presentation state 
such as tab stops and character sets . The terminal provides 
control functions to query state in each of these catagories, as 
well as a compact report that allows most settable state to be 
saved and later restored in one operation. 

All TSI controls operate at Levels 2, 3 and 4. Level 3 defines 
TSI as an implicit extension at Level 2 . The following control 
functions are provided to support Terminal State Interrogation. 

DECRQM - Request Mode 

Sequence sent from host to terminal to request the state of a 
single mode. 

DECRPM - Report Mode 

Sequence sent from terminal to host to report the state of 
the mode requested by DECRQM. 

DECNKM - Numeric Keypad Mode 

This is a selectable mode sequence which controls the keypad 
allowing its state to be reported by DECRPM above. See 
"Keyboard Processing", DEC STD 70-6. 

DECRQSS - Request Selection or Setting 
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Sequence sent from host to terminal to request the state of a 
selection or setting which is not encoded as a selectable 
mode (example: SGR) . 

DECRPSS - Report Selection or Setting 

Sequence sent from terminal to host to report settings and 
selections in response to DECRQSS . 

DECRQPSR - Request Presentation State Report 

Sequence sent from host to terminal to request presentation 
state (cursor information and tab stops) 

DECPSR - Presentation State Report 

Control string sent from terminal to host in response to 
DECRQPSR. Two presentation state reports are defined: (1) 

Cursor Information Report - DECCIR; (2) Tabulation Stop 
Report - DECTABSR 

DECRSPS - Restore Presentation State 

Control string sent from host to terminal to restore the 
presentation state reported by DECPSR. 

DECRQTSR - Request Terminal State Report 

Sequence sent from host to terminal to request a compact 
report of most settable state. 

DECTSR - Terminal State Report 

Control string sent from terminal to host which reports most 
terminal state in one compact sequence. 

DECRSTS - Restore Terminal State 

Control string sent from host to VT420 to restore the 
terminal state reported by DECTSR. 
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REQUEST MODE 


DECRQM 


Levels: 2x (TSI) , 3-4 


Purpose: To request the state of modes controlled by Set 

Mode/Reset Mode sequences . 


Format : 


CSI 


Ps 

$ 

P 

(ANSI modes) 

CSI 

? 

Ps 

$ 

P 

(DEC private modes) 

9/11 

3/15 

Ps 

2/4 

7/0 



Description: This sequence takes one selective parameter 

specifying a single selectable mode controllable using the Set 
Mode and Reset Mode sequences . The terminal responds with a 
Report Mode control sequence (DECRPM) which specifies the state of 
the mode as follows: (0) Unknown (mode is not recognized by 

terminal) ; (1) Set; (2) Reset; (3) Set and cannot be changed; or 

(4) Reset and cannot be changed. 

All ANSI standard modes defined in X3. 64-1979 are reported as 
either Set or Reset . DEC Private modes that cannot be set or 
reset from the host will report as unknown [Reason: the list is 
long and changes frequently. Since DEC defines these modes, 
applications can infer how to handle unknown modes as needed] . 
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Implementation Guideline 

The VT420 allows the following selectable modes to 
be queried through the use of the DECRQM control: 

ANSI Specified DEC Private 

Mode Parameter Mnemonic Mode Parameter Mnemonic 


1 

GATM 

* 

?i 

DECCKM 

2 

KAM 


?2 

DECANM *** 

3 

CRM ** 

?3 

DECCOLM 

4 

IRM 


?4 

DECSCLM 

5 

SRTM 

* 

?5 

DECSCNM 




?6 

DECOM 

7 

VEM 

■k 

?7 

DECAWM 

10 

HEM 

k 

?8 

DECARM 

11 

PUM 

k 



12 

SRM 




13 

FEAM 

k 



14 

FETM 

k 



15 

MATM 

k 



16 

TTM 

k 

?18 

DECPFF 

17 

SATM 

k 

?19 

DECPEX 

18 

TSM 

k 

?25 

DECTCEM 

19 

EBM 

k 



20 

LNM 


?42 

DECNRCM 




?60 

DECHCCM * 




?61 

DECVCCM 




?64 

DECPCCM 




?66 

DECNKM 




?67 

DECBKM 




?68 

DECKBUM 




?69 

DECVSSM 




?73 

DECXRLM 


* This mode is always Reset in the VT420 and 
can not be changed. 

** The terminal will not respond to a DECRQM sequence 
while in Control Representation Mode (this mode can 
only report RESET) . CRM can not be changed from 
the host . 

*** The terminal will not respond to a DECRQM sequence 

when not in ANSI mode (this mode can only report SET) . 
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REPORT MODE 


DECRPM 


Levels: 2x (TSI) , 3-4 


Purpose: To report the state of modes controlled by Set 

Mode/Reset Mode sequences (terminal to host) . 


Format: CSI 

CSI ? 
9/11 3/15 


Psl 

; Ps2 

$ 

y 

Psl 

; Ps2 

$ 

y 

Psl 

; Ps2 

2/4 

7/9 


(ANSI modes) 

(DEC private modes) 


Description: This sequence is returned to the host upon receipt 

of a valid DECRQM control sequence. This sequence reports the 
state of a particular selectable mode to the host. The first 
selective parameter (Psl) is the selectable mode number (the 
question mark ("?") must be added for DEC private selectable 
modes), that was requested from the DECRQM sequence. The second 
selective parameter (Ps2) indicates the state of that mode: 

Ps2 State of mode 


0 UNKNOWN (mode not recognized by terminal) . 

1 Mode is in SET state 

2 Mode is in RESET state 

3 Mode is in SET state, and cannot change 

4 Mode is in RESET state, and cannot change 
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REQUEST SELECTION OR SETTING DECRQSS 

Levels: 2x (TSI) , 3-4 

Purpose: To request the state of a selection or setting which is 

not encoded as a Set Mode/Reset Mode sequence . 

Format: DCS $ q D. . .D ST 

9/0 2/4 7/1 D...D 9/12 


Description: Request Selection or Setting is sent to the terminal 

to determine the selection or setting of a single device feature, 
such as the current Graphic Rendition (SGR) . The data of the 
device control string for DECRQSS contains the identifying 
intermediate and final characters of the control sequence used to 
make the selection. For example, if the command is to request the 
state of SGR, the data would consist of a single character ' m' f 
which is the final character (no intermediates) in the control 
sequence for SGR. The terminal responds with a Report Selection 
or Setting (DECRPSS) sequence. 

Only one setting or selection may be queried per request. 

Implementation Guideline 

The VT420 allows the state of features selectable 
through the following sequences to be determined 
through DECRQSS: 

Setting Control Sequence Abbreviation Final Character (s) 


Select Active Status Display 

Select Attribute Change Extent 

Set Character Attribute 

Set Conformance Level 

Set Columns Per Page 

Set Lines Per Page 

Set Number of Lines per Screen 

Set Status Line Type 

Set Left and Right Margins 

Set Top and Bottom Margins 

Set Graphic Rendition 


DECSASD 

DECS ACE 

DECSCA 

DECSCL 

DECSCPP 

DECSLPP 

DECSNLS 

DECSSDT 

DECSLRM 

DECSTBM 

SGR 


$ } 
* X 



$ I 


t 

* I 
$ - 
s 
r 
m 
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REPORT SELECTION OR SETTING DECRPSS 


Levels: 2x (TSI) , 3-4 

Purpose: To report the state of a selection or setting which is 

not encoded as a Set Mode/Reset Mode sequence (terminal to host) . 


Format: DCS Ps $ r D. . .D ST 

9/0 Ps 2/4 7/2 D...D 9/12 


Description: The Report Selection or Setting device control 

string is issued from the terminal in response to a Request 
Selection or Setting command. The value of Ps indicates whether 
the Request was successful: 

Ps meaning 


0 UNKNOWN selection or setting, request unsuccessful 

1 request successful, data contains selection information 

The data returned by the DECRPSS control string is the entire 
control function that the host would send to the terminal to 
select or set the parameter being inquired, based on the current 
setting or selection of that parameter, with the single exception 
of the leading Control Sequence Introducer character (9/11, or 
1/11 5/11 in 7 bits) . 

The returned control function will contain no omitted parameters, 
even if the inquired value is the default value. In the case 
where there is no default value for the inquired parameter, the 
returned control function will be constructed so as to overwrite 
the existing setting or selection, if and when that information is 
returned to the device. 

For example, if the current Graphic Rendition is blinking, and 
reversed, the data would consist of the characters '0;5;7m', which 
is the parameter string and final character necessary to change 
the graphic rendition to that state. 

Note that the coding of the DECRPSS control string which indicates 
UNKNOWN, is always coded as follows: 


DCS 0 $ r ST 
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REQUEST PRESENTATION STATE REPORT DECRQPSR 

Levels: 2x (TSI) , 3-4 

Purpose: To request presentation state (cursor information and 

tab stops) . 


Format: CSI Ps $ w 

9/11 Ps 2/4 7/7 


Description: DECRQPSR causes the terminal to respond with a 

Presentation State Report (DECPSR) . The control sequence takes 
one selective parameter which specifies the type of Presentation 
State Report to be returned. 

Ps Type of DECPSR 


0 ignored, no report sent 

1 Cursor Information Report (DECCIR) 

2 Tabulation Stop Report (DECTABSR) 
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PRESENTATION STATE REPORT DECPSR 

Levels: 2x (TSI) , 3-4 

Purpose: To report the presentation state (cursor information and 

tab stops, terminal to host) . 

Format: DCS Ps $ u D...D ST 

9/0 Ps 2/4 7/5 D...D 9/12 


Description: The Presentation State Report is a device control 

string containing data which represents the settings of 
presentation attributes in the terminal. A Presentation State 
Report is sent in response to a Request Presentation State Report 
control sequence (DECRQPSR) . 

The type of Presenation State Report is specified by the value of 
Ps : 

Ps Type of DECPSR 


0 illegal 

1 Cursor Information Report 

2 Tabulation Stop Report 


(DECCIR) 

(DECTABSR) 


VSRM - Character Cell Display EL-00070-05 Page 5-200 

Digital Internal Use Only - For Review Only 29-Jun-1990 


I CURSOR INFORMATION REPORT DECCIR 


Levels: 2x (TSI) , 3-4 

Purpose: To report the presentation state cursor information 


Format: DCS 1 $ u D...D ST 

9/0 3/1 2/4 7/5 D...D 9/12 


Description: The data of a device control string for a Cursor 

Information Report consists of a string of parameters containing 
the information saved through a Save Cursor (DECSC) command, 
according to the following format: 

Pr / Pc ; Pp ; Srend ; Satt ; Sflag ; Pgl / Pgr ; Scss ; Sdesig 

where : 

Pr, Pc The cursor position (example: 24/132) 

Pp The current page (example: 3) 

Note that in a single page configuration, the 
Pp parameter would be 1 . 

Srend One or more bytes containing the encoded 

Graphic Renditions that must be saved, 
according to the following bit-encoded format: 

bit 8: always reset (0) 
bit 7: always set (1) 

bit 6: extension indicator: if this bit is 
set (1) , another byte of rendition 
information follows (always reset on 
VT420) . 

bit 5: always reset (0) 

bit 4 : reverse video rendition 

bit 3: blink rendition 

bit 2 : underline rendition 

bit 1 : bold rendition 

For the actual rendition bits (1 through 5, 
above) if the bit is set (1) , it indicates 
that the rendition has been selected. 

Example: if bold and underline are set the 

terminal would report a single byte, coded in 
binary as 01000011, or a hex 43, ASCII "C" . 

One or more bytes containing the encoded 
Character Attributes that must be saved, 
according to the following bit-encoded format: 


Satt 
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bit 8: always reset (0) 
bit 7: always set (1) 

bit 6: extension indicator: if this bit is 
set (1) , another byte of character 
attribute information follows 
(always reset on VT420) . 
bit 5: reserved for future use 
bit 4: reserved for future use 
bit 3: reserved for future use 
bit 2: reserved for future use 
bit 1: selectively erasable attribute 

For the actual character attribute bits (1 
through 5, above) if the bit is set (1) , it 
indicates that the character attribute has 
been selected. Example: if the selective 
erase attribute is set, the terminal would 
report a single byte, coded in binary as 
01000001, or a hex 41, ASCII "A". 

Sflag One or more bytes containing several flags and 

modes that must be saved, according to the 
following bit-encoded format: 

bit 8: always reset (0) 

bit 7: always set (1) 

bit 6: extension indicator: if this bit is 

set (1) , another byte of flags follows 
(always reset on VT420) . 
bit 5 : reserved for future use 
bit 4: auto-wrap pending (1 if pending) 
bit 3: SS3 pending (1 if SS3 received) 
bit 2: SS2 pending (1 if SS2 received) 
bit 1: origin mode (1 = set 0 = reset) 

For the flags above, if the bit is set (1) it 

indicates that the mode or state is set (as 
indicated) . Example: if origin mode DECOM is 
set, auto-wrap is pending, and an SS3 has been 
received, the terminal would report a single 
byte, coded in binary as 01001101, or a hex 
4D, ASCII "M". 

Pgl, Pgr Character G-sets which are currently invoked 
into GL and GR. These parameters are 
characters from 0 through 3, depending on 
which of GO, Gl, G2, or G3 are invoked into GL 
and GR, respectively. 

One byte containing the encoded information 
regarding the size of the character sets 
designated into GO through G3 according to the 
following bit-encoded format: 


Scss 
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bit 8: always reset (0) 
bit 7: always set (1) 

bit 6: extension indicator: if this bit is 
set (1) , another byte of character 
size information' follows (always 
reset on VT420) . 
bit 5 : reserved for future use 
bit 4 : size of G3 set 
bit 3: size of G2 set 
bit 2: size of G1 set 
bit 1: size of GO set 

For the character set size bits (1 through 4, 
above) if the bit is set (1) , it indicates 
that the graphic set contains a 96-character 
character set. If the bit is reset, the 
graphic set contains a 94 -character character 
set. Example: if ISO Latin Alphabet Nr 1 
Supplemental, a 96-character character set is 
designated into G2 and G3, and ASCII, a 
94 -character character set is designated into 
GO and Gl, the terminal would report a single 
byte, coded in binary as 01001100 = hex 4C = 
ASCII "L". 

Sdesig A string of bytes which consist of the strings 
of designating tails of the character sets 
designated into GO, Gl, G2, and G3, in that 
order. The designating tail consists of the 
intermediate and final characters of the 
Select Character Set (SCS) designating escape 
sequence for the character set . 

(Example: If ASCII were designated into GO, 

the Line Drawing (DEC Special Graphics) set 
into Gl, and the DEC Supplemental Set into G2 
and G3, the value of Sdesig would be: 

'B0%5%5' ) 

Note: this string is deliberately placed at 

the end of the data of the DECCIR control 
string, because the semicolon (;) separator 
character used between the previous parameters 
is a valid character in a SCS escape sequence . 

Note: This string will report the User 

Preference Supplemental Set (UPSS) designator 
if that is how a character set was designated. 
DECRQUPSS can be used to determine the actual 
UPSS if needed. 
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Example 

An example DECCIR report, assuming the default 
state of the terminal would be: 

<DCS>1 $ul / 1 ; 1 ; @ @ ; 0 ; 2 ; @ ; BB« <ST> 

indicating that : 

"1/1; 1" - cursor home on first page 

- no graphic rendition or character 
attribute active; DECOM reset, no SS2, SS3, or 
auto-wrap is pending 
(ASCII @ is binary 01000000) 

— " 0 ; 2 " — GO in GL and G2 in GR 

- all character sets designated are 
94-character character sets 

- "BB«" - ASCII in G1 and G2, User Preference 
Supplemental Set in G2 and G3 
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TABULATION STOP REPORT DECTABSR 

Levels: 2x (TSI) , 3^4 

Purpose: To report the presentation state tab stops 

Format: DCS 2 $ u D. . .D ST 

9/0 3/2 2/4 7/5 D...D 9/12 


Description: The data of a device control string for a Tabulation 

Stop Report consists of a string of numeric parameters specifying 
where tabulation stops are currently set in the terminal, 
separated by slash ("/") characters. An example of a DECTABSR 
when the terminal has 8 column tabs set would be as follows: 


DCS 2 $ u 9 / 17 / 25 / 33 / 41 / 49 / 57 / 65 / 73 ST 
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RESTORE PRESENTATION STATE DECRSPS 

Levels: 2x (TSI) , 3-4 

Purpose: To report previously reported presentation state (cursor 

information or tab stops) . 


Format: DCS Ps $ t D...D ST 

9/0 Ps 2/4 7/4 D...D 9/12 


Description: This device control string is sent to reset the 

terminal to the presentation state described in the data of the 
control string. This DCS takes one selective parameter, which 
indicates the format of the data of the DCS. The data of the DCS 
must be in the format of one of the Presentation State Reports 
(DECPSR) . The type of DECPSR format that the data consists of is 
specified by the selective parameter: 

Ps Type of DECPSR 


0 error, restore ignored 

1 Cursor Information Report (DECCIR) 

2 Tabulation Stop Report (DECTABSR) 

When this sequence is received by the terminal, the terminal will 
begin to change the terminal state according to the state encoded 
in the data of the control string. 

If an invalid value is detected, the terminal will ignore the 
error, if possible, and if not will ignore the remainder of the 
data, parsing until a ST control is encountered. This may leave 
the terminal state partially unrestored. No error indication is 
returned to the host. 


VSRM - Character Cell Display EL-00070-05 Page 5-206 

Digital Internal Use Only - For Review Only 29-Jun-1990 


REQUEST TERMINAL STATE REPORT DECRQTSR 


Levels: 2x (TSI) , 3-4 

Purpose: To request a compact report of most settable state. 


Format: CSI Ps $ u 

9/11 Ps 2/4 7/5 


Description: DECRQTSR causes the terminal to issue a Terminal 

State Report (DECTSR) . Terminal State Reports transmit 
information on global state within the terminal. The type of 
DECTSR returned depends on the value of the selective parameter. 

Ps Type of DECTSR 


0 ignored, no report sent 

1 Terminal State Report (DECTSR) 

If the terminal does not recognize the type of DECTSR requested, 
the entire command is ignored. 
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TERMINAL STATE REPORT (1) DECTSR 


Levels: 2x (TSI) , 3-4 

Purpose : To report most settable terminal state in one compact 

sequence . 


Format: DCS 1 $ s D...D ST 

9/11 3/1 2/4 7/3 D...D 9/12 


Description: The Terminal State Report is a device control string 

containing a collection of terminal device attributes. A Terminal 
State Report is sent in response to a Request Terminal State 
Report control sequence (DECRQTSR) with Selective Parameter "1". 

The data of the device control string for a Terminal State Report 
consists of a Sixel encoded, string of 8-bit bytes which contains 
the the state information for the device. This string is 
guaranteed not to be longer than 256 characters, including the DCS 
control character, introducer sequence, and ST control character. 

The state information reported is the same as the state 
information available through the other discrete TSI controls. 

This generally represents all settable state in the terminal with 
the exception of large data items that are not practical to report 
(the contents of the logical display, DRCS, UDK definitions, and 
Macros) . 

The format of the data is firmware revision dependent. Software 
should not expect the format to remain the same across firmware 
revisions or different members of a terminal family. 

The format of DECTSR is: DCS 1 $ s Dl...Dn <checksuml> <checksum2> ST 

Where Dl...Dn are data reported 

<checksuml> <checksum2> is a two bytes check sum of Dl...Dn 

(checksum = 2's complement of D1 + D2 + ... + Dn; 

8-bit addition with no Carry) 


Implementation Guideline: 

On the VT420, there are 110 bytes in Dl...Dn, 
system parameters are contained in low nibble of 
each byte, and Dl...Dn are in the range 4/0 to 
4/15 (bit 6 of Dn always set, bit 7,5,4 of Dn 
always reset) . 
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RESTORE TERMINAL STATE DECRSTS 

Levels: 2x (TSI) , 3-4 

Purpose: To restore previously reported terminal state (DECTSR) . 

Format: DCS Ps $ p D...D ST 

9/0 Ps 2/4 7/0 D...D 9/12 


Description: This device control string is sent to reset the 

terminal to the state described in the data of the control string. 
This DCS takes one selective parameter, which indicates the format 
of the data of the DCS. The data of the DCS must be in the format 
of one of the Terminal State Reports (DECTSR) . The type of DECTSR 
format that the data consists of is specified by the selective 
parameter : 

Ps Type of DECTSR 


0 illegal, restore ignored 

1 Terminal State Report (DECTSR) 

When this sequence is received, buffered, and checksummed by the 
terminal, the terminal will begin to change the terminal state 
according to the state encoded in the data of the control string. 
If the checksum fails, the entire sequence is ignored. If an 
invalid value is detected, the terminal will ignore the error if 
possible, and if not, ignore the remainder of the data, parsing 
until a ST control is encountered. This may leave the terminal in 
a partially unrestored state. No error indication is returned to 
the host . 


Note 

Software should not depend on the format of the 
Terminal State Report (DECTSR) to be the same 
across members of the VT400 family, nor even 
across different firmware revisions of a single 
terminal model . Software should not use DECRSTS 
to restore a terminal to a saved state unless that 
state was previously read from the terminal. 
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5.14 INTERNAL FUNCTIONS AND PROCEDURES 

5.14.1 End Of Line 

/************* 

* 

* end_of_line 

* This function returns the last position of the line 

* based on its line attributes and column mode. 

* 

* assumes line is on the current page 

************* j 

short int end_of_line (line) 
line_t line; 

{ 

I line_t base; /* first line(-l) of page */ 
column t end line; 

/* *7 

if (column_mode = ONE_THIRTY_TWO) end_line = 132; 
else end_line = 80; 

I base = (active_position. page-1) * lines_per_page; 

I if {line_rendit ion [line + base] != SINGLE_WIDTH) 
end_line /= 2; 
return (end_line) ; 

} 
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5.14.2 Scroll Up 

/**************** 

* 

* scroll_up 

* 

* This procedure causes the scroll area between the line 

* designated and the Bottom Margin (inclusive) on the 

* active page to scroll upward by the number of lines 

* designated in the count . Line and Character Renditions 

* are scrolled with the data. A new single-width line with 

* all character positions empty is inserted at the Bottom Margin. 

* Lines scrolled off the top of the scrolling region are lost. 

* 

******************/ 
void scroll_up (top_line, count) 
line_t top_line; 

1 ine_t count ; 

{ 

line_t y; 
column_t x; 

I line_t base; /* first line{-l) of page */ 

1 /* */ 

I base = {active_j50sition .page-1) * lines_per_page/ 
while (count > 0) 

{ 

I for (y=top_line+base; y<bottom_margin+base; y++) 

{ 

line_rendition [y] = line_rendition [y+1 ] / 

I for (x=left_margin; x<=right_margin; x++) 

strncpy ( display [y] [x] , display [y-1 ] [x] , 
sizeof (character_t) ) ; 

} 

line_rendition [bottom_margin+base] = SINGLE_WIDTH; 
for (x=left_margin; x<=right_margin; x++) 

display [bottom_margin] [x] .code = EMPTY_CHARACTER; 
count -= 1 ; 

} 

} /* end scroll_up */ 


I 

I 
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5.14.3 Scroll Down 

/**************** 

* 

* scroll_down 

* 

* This procedure causes the scroll area between the line 

* designated and the Bottom Margin (inclusive) on the 

* active page to scroll downward by the number of lines 

* designated in the count . Line and Character Renditions 

* are scrolled with the data. A new single-width line with 

* all character positions empty is inserted at the Top Margin. 

* Lines scrolled off the bottom of the scrolling region are lost. 

* 

****************** j 

void scroll_down (top_line, count) 
line_t top_line; 

1 ine_t c ount / 

{ 

line_t y; 
column_t x; 

I line_t base; /* first line(-l) of page */ 

I /* */ 

1 base = (activejsosition. page-1) * lines_per_page; 
while (count > 0) 

{ 

I for (y=bottom_margin+base; y>top_line+base/ y--) 

{ 

line_rendition [y] = line_rendition [y-1] ; 

I for (x=left_margin; x<=right_margin; x++) 

strncpy ( display [y] [x] , display [y-1] [x] , 
sizeof (character_t ) ) ; 

} 

I line_rendition [top_line+base] = SINGLE_WIDTH; 

I for (x=left_margin; x<=right_margin/ x++) 

display [top_line] [x] .code = EMPTY_CHARACTER; 
count -= 1; 

} 

} /* end scroll down */ 
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5.14.4 Scroll Left 

/**************** 

* 

* scroll_left 

* 

* This procedure causes the scroll area between the column 

* designated and the Right Margin (inclusive) on the 

* active page to scroll leftward by the number of columns 

* designated in the count . A new column with all character 

* positions empty is inserted at the Right Margin. 

* Characters scrolled past the scrolling region are lost. 

* 

******************/ 

void scroll_left (left_column, count) 
column_t left_column; 
column t count; 


{ 

line_t y; 
column_t x; 

line_t base; /* first line(-l) of page */ 

/* */ 


base = (active_position. page-1) * lines_per_page; 
while (count > 0) 

{ 

for (y=top_margin+base; y<=bottom_margin+base; y++) 

{ 

for (x=left_coluinn; x<right_margin; x++) 
strncpy ( display [y] [x] , display [y] [x+1] , 
sizeof (character_t) ) ; 

display [y] [right_margin] .code = EMPTY_CHARACTER; 

} 

count -= 1; 

} 

} /* end scroll left */ 
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5.14.5 Scroll Right 

/**************** 

* 

* scroll_right 

* 

* This procedure causes the scroll area between the column 

* designated and the Right Margin (inclusive) on the 

* active page to scroll right by the number of columns 

* designated in the count . A new column with all character 

* positions empty is inserted at the designated column. 

* Characters scrolled past the scrolling region are lost. 

* 

****************** ! 

void scroll_right (left_column, count) 
column_t left_column; 
column_t count; 

{ 

line_t y; 
column_t x; 

line_t base; /* first line{-l) of page */ 

/* */ 

base = (active_position. page-1) * lines^er_page; 
while (count > 0) 

{ 

for (y=top_margin+base; y<=bottom_margin+base; y++) 

{ 

for (x=right_margin; x>left_column; x--) 
strncpy ( display [y] [x] , display [y] [x-1 ] , 
sizeof (character_t ) ) ; 

display [y] [left_column] .code = EMPTY_CHARACTER; 

} 

count -= 1 ; 

} 

} /* end scroll_right */ 
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5.15 CONTROL FUNCTION REFERENCE TO OTHER CHAPTERS 

This subsection lists ANSI control functions that are not 
described in this chapter (DEC STD 70-5, Character Cell Display) 
and indicates where in the VSRM they are described as a reference 
to the rest of ANSI host interface. 


Control Function Reference 


Terminal Management Functions 
DA - Device Attributes 

DECRPTUI - Report Terminal Unit ID 

DSR - Device Status Report 

DECID - Identify Device 

DECSCL - Select Conformance Level 

DECSR - Secure Reset 

DECSRC - Secure Reset Confirmation 

DECSTR - Soft Terminal Reset 

DECSTUI - Set Terminal Unit ID (Restricted) 

RIS - Reset to Initial state 

Code Extension Functions 

Announce Subset of Code Extension Facilities 
Locking Shifts: LSO, LSI, LS2, LS3, LSIR, LS2R, LS3R 
Single Shifts: SS2, SS3 
S7C1T - Select 7-bit Cl Transmission 
S8C1T - Select 8-bit Cl Transmission 
Keyboard Processing Functions 


DECARM 

- 

Autorepeat Mode 

DECBKM 

- 

Backarrow Key Mode 

DECCKM 

- 

Cursor Keys Mode 

DECKBUM 

- 

Keyboard Usage Mode 

DECKPAM 

- 

Keypad Application Mode 

DECKPNM 

- 

Keypad Numeric Mode 

DECNKM 

- 

Numeric Keypad Mode 

DSR 

- 

Device Status Report (keyboard status) 

PCAM 

“ 

Keyboard Action Mode 

DECLFC 


Local Functions Control 

DECLFKC 

- 

Local Function Key Control 

DECSMKR 

- 

Select Modifier Key Reporting 

DECKPM 

- 

Key Position Mode 

DECEKBD 

- 

Extended Keyboard Report 


Terminal Synchronization 
XON 
XOFF 
BREAK 

DECXRLM - Transmit Rate Limiting Mode 
Extensions 
DRCS 

DECDLD - Downline Load 
UDK 

DECUDK - User Defined Keys 
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DSR - Device Status Report (UDK lock) 
Session Management Extension 
DECES - Enable Sessions 
Printer Port 

DECPEX - Print Extent Mode 
DECPFF - Print Form Feed Mode 
DSR - Device Status Report (printer port) 
MC - Media Copy 

Status Display 

DECSASD - Select Active Status Display 
DECSSDT - Select Status Display Type 
Documented Exceptions 
DECANM - ANSI/VT52 Mode 
DECALN - Screen Alignment 
DECAVJM - Autowrap Mode 
DECTST - Invoke Confidence Test 
CRM - Control Representation Mode 
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5.16 CHANGE HISTORY 
5.16.1 Rev 0.4 To 0.5 

The following changes were made at this revision to properly 
integrate this section with the rest of the Video Systems 
Reference Manual : 

1 . The name was changed from "Character Cell Display Level 
1" to "Character Cell Display". All references to Level 
1 operation only were removed, and explicit reference to 
both Level 1 and Level 2 operation was added for all 
functions . 

2. The Reference Standards section was updated. 

3. The Conformance section, the list of conforming products, 
and the tables of required functions were removed and 
made a separate chapter in the Video SRM ("Conformance 
Requirements") . 

4 . The program flow diagrams and the executive routines were 
moved to the chapter "Specification Program Structure". 

5 . The Reset to Initial State control was moved to the 
chapter "Terminal Management". 

6 . Some variable names were changed to be consistent with 
their use throughout the rest of the Video SRM. 

7. The algorithm for Insert or Replace Character was 
corrected to include the processing of Single Shift 
control functions. 

8 . The Set Mode and Reset Mode control functions were moved 
to the chapter "Specification Program Structure", and 
their detailed implementation was broken out into a 
separate section for each mode related to Character Cell 
Display operation. 

9. The description of Blink rendition was changed. 

10. A note was added concerning software dependence on the 
speed of implementing changes of state in Screen Mode. 

11. The purpose section for Line Feed, Vertical Tab, Form 
Feed, Index, Reverse Index, and Next Line was reworded to 
indicate scrolling if necessary, and to indicate (where 
appropriate) the use of fallback implementation in video 
terminals . 

12. The section on Substitute was reworded to remove the 
reference to "fallback" character. 
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13. The note on software use of Horizontal and Vertical 
Position was changed to remove the reference to 
retransmission . 

14. A definition was added for the term "Margin". 

15. Beginning of line and end of line conditions were added 
to the Erase In Display algorithm. 

16. Clearing of the Last Column Flag was added to the 
algorithms for Delete Character and Reset Auto Wrap Mode . 

17. A note was added to the section on slow scrolling to 
indicate that it must render text "recognizable", but not 
necessarily "readable" . 

18. A note was added on conforming software use of Double 
Height lines . 

19. A section was added for Character Set Selection, which 
was previously a part of the chapter "Code Extension 
Layer" . 

20. A section was added for the Warning Bell, which was 
previously a part of the "Terminal Management" chapter. 

21. A section was added for Text Cursor Enable Mode, which 
was previously a part of the "Terminal Management" 
chapter . 

22. A section was added for Control Representation Mode, 
which is currently planned for Level 2 terminals (subject 
to review) . 
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5.16.2 Revision 0.5 To AXIO 


1. Added the Selectively Erasable Characters extension, 
which required the following: 

1. A state description for Character Attributes. 

2 . New entries in the state tables . 

3 . Addition of the Select Character Attribute (DECSCA) 
control function. 

4. Modification of the Erase In Line (EL) and Erase In 
Display (ED) control functions. 

5. Addition of the Selective Erase In Line (DECSEL) and 
Selective Erase In Display (DECSED) control 
functions . 

It also required changes to the following routines: 

Insert or Replace Graphic Character 
Save Cursor 
Restore Cursor 

2. Removed Control Representation Mode (CRM) to an appendix 
to the SRM. It will not be invokable from the host. 

3 . Added the Erase Character (ECH) and Insert Character 

(ICH) control functions. 

4 . Added a note to the description of Auto Wrap Mode to 
indicate that Space characters also affect the wrap 
condition. 

5. Added the following control functions to the list of 
functions which clear the Auto Wrap state (Last Column 
Flag) : 

Erase Character 
Insert Character 
Erase In Line 
Selective Erase In Line 
Erase In Display 
Selective Erase In Display 

6 . Added a note that the Current Attribute is saved in the 
Cursor Save Buffer if the Selectively Erasable Characters 
extension is supported. 

7. Added values to the Select Graphic Rendition (SGR) 
control function for Level 2 to turn off Bold, Blink, 
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Underscore, and Reverse renditions. 

8 . Made minor corrections to the algorithms for Double Width 
and Double Height lines. 

9. Added a note to the Substitute control function referring 
to the section "Code Extension Layer" for the handling of 
Substitute within escape and control sequences. 

10. Added a deviation note to the Index control function for 
the VTIOO and VT125 to indicate that in these terminals 
the control is affected by the setting of New Line Mode. 

11. Changed the algorithm for Tabulation Clear (TBC) to 
process multiple selective parameters. 

12. Made extensive changes to the algorithms for Erase In 
Line (EL) and Erase In Display (ED) to provide the 
following: 

o processing of multiple selective parameters. 

o setting of line rendition to single width when all 
characters are erased. 

o processing of private parameter for selective 
erase function. 

13. Corrected the coding of Delete Character (DCH) , which is 
CSI Pn P. 

14. Added a note on the use of User Preference Features 

(modes) which are not to be used by software except in 
response to an explicit user request. 

15. Made notes that setting and resetting Column Mode 
(DECCOLM) will clear the screen, etc., even if the 
terminal was already in the selected state. 

16. Noted that the Warning Bell may be disabled in Setup. 

17. Modified the descriptions of Vertical Tab (VT) and Form 
Feed (FF) to point to the Line Feed algorithm. 

18. Made Insert Replacement Mode (IRM) , Delete Character 

(DCH) , Delete Line (DL) , and Insert Line (IL) a Level 1 
Editing Extension, which is required in all future Level 
1 implementations, and in Level 2. Removed all VTIOO 
family deviation notes on these functions. 

19. Made Auto Wrap Mode an exception to Level 1, and removed 
all references to this and the Last Column Flag. Also 
removed all VTIOO family deviation notes on this 
function . 
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20. Modified the Save Cursor (DECSC) and Restore Cursor 
(DECRC) descriptions to differentiate between Level 1 and 
Level 2 functionality. 

21. Added a character set table to the state descriptions and 
modified the algorithms for Designate Character Set to 
accommodate redefinition of the designator sequences 
using DRCS . 

22 . Corrected dual coding in the algorithm for Insert or 
Replace Graphic Characters . 

23. Added a note to the Restore Cursor control indicating the 
handling of the condition in which the cursor is restored 
outside of the scrolling region with Origin Mode set . 

24. Made corrections in the algorithms for Erase Character, 
Delete Character, Insert Character, Delete Line, and 
Insert Line . 

25 . Added a note on the use of the UK character set in Level 
1 operation to the section on character set designation. 


5.16.3 Rev AXIO To AXll 


1. Removed Rev AXIO change bars. Added change bars to any 
change that could affect conformance or interpretation of 
the document or should be brought to the attention of 
terminal implementors or software engineers . 

2 . Added note that level 2 SGR parameters may be recognized 
when device is operating in level 1 mode, but that 
conforming software shall not rely on this feature. 

3. Corrected sense of Selectively Erasable Attribute (set 
using DECSCA) . The default or attribute off condition is 
that characters are selectively erasable. 
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5.16.4 Rev AXll To RX12 


1. Removed Rev AXll change bars. Added change bars to any 
change that could affect conformance or interpretation of 
the document or should be brought to the attention of 
terminal implementors or software engineers . 

2. Updated Reference Standards section and put at end after 
Change History per convention for other chapters. 

3 . Added section to Introduction explaining chapter 
organization as a number of small sections. Re-organized 
entire chapter to group related controls by function 
instead of syntax. 

4. Modified all code to operate on the current page. 

Terminology Section: 

5. Removed definitions of the following terms which are 
defined in the Code Extension section: 

Bit Combination 
Character 
Control Character 
Control Function 
Control Sequence 
Control String 
Escape Character (ESC) 

Escape Sequence 
Final Character 
Intermediate Character 
Numeric Parameter 
Parameter 
Parameter String 
Selective Parameter 

6. Added definition of Logical Display - the lines and 
columns available for storing and presenting graphic 
characters as seen by the application or host computer. 

A Logical Display may be organized as a single 
rectangular array of lines and columns (one page ) , or 
divided into a number of identically sized pages, each of 
which is a rectangular array of lines and columns. 

7. Added definition of Page - An addressable area of a 
Logical Display organized as a rectangular array of lines 
and columns. The number of lines and columns defines the 
Page Size. 

Added subsection titled "Code Extension Terms" listing 
terms defined in the Code Extension chapter of the VSRM 
(DEC STD 70-3) . 


8 . 
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9. Removed the following terms which do not appear in the 
text of the chapter: Introducer; Transfer; Transmission 
Control . 

10. Clarified definition of Control Sequence Introducer (CSI) 
- The Cl control (represented by a single character in 
8-bits, or a two character ESC Fe sequence in 7-bits) 
which initiates a control sequence. CSI is a prefix 
affecting the interpretation of a limited number of 
contiguous bit combinations. [This should be in the Code 
Extension chapter as well, but isn't at this time] 

11. Clarified definition of Default - A function-dependent 
value that is assumed when no explicit value, or a value 
of 0, is specified. 

12 . Clarified definition of Margin - A line which marks the 
upper or lower boundary of the scrolling region (vertical 
scroll margin) . A column which marks the left or right 
boundary of the scrolling region (horizontal scroll 
margin) . 

Display Coordinate System and Addressing 

13. Logical Display: Described concept of Logical Display 
and Page Size, default sizes, and ability to change it. 

14. Margins and Scrolling: Re-organized text to combine 
syntax and semantics to be easier to follow. Added 
section summarizing interaction of controls with 
scrolling region. Added list of controls defined in this 
section. Added descriptions for: DECSLRM, DECLRMM, 
DECFI, DECBI to support left and right margins. 

15. Cursor Movement: Added DECXCPR extended cursor position 
report for use at Level 4, or with the Windowing 
Extension. Updated algorithms for CUF and CUB to check 
right and left margins . 

Page Size and Arrangement: 

16. Added description of DECSCPP and DECSLPP to support Level 
4, or Windowing Extension. 

Page Movement : 

17 . New Subsection describing page movement controls for use 
at Level 4, or with the Windowing Extension. 

Windowing Extension: 

18. Completely new subsection describing Windowing Extension. 
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Visual Renditions 

19. Added new subsection on ANSI Color Text Extension. SGR 
parameters 31-37, 39, 41-47, 49. Color Maps. DECCTR - 
color table report. Interactions with other visual 
attributes. Guidelines for default color assignment. 
DECSTGLT - Select Text Graphics Look-Up Table (for 
alternate text rendition mapping) . 

Graphic Character Sets 

20. Expanded section on Grahic Character sets including which 
sets are required at different conformance levels and 
extensions. Designating sequences for character sets. 
8-bit Interface Architecture Extension. NRCS Extension. 

Editing Functions: 

21. Modified description of character insertion to cover 
behavior with respect to the margins . 

22. Modified description of ICH, IL, and DL to be restriced 
to text within the Left Right Margins . 

23. Added descriptions of DECIC and DECDC to support left and 
right margins . 

24. Noted ECH, EL, DECSEL, ED, and DECSED are not affected by 
the margins . 

OLTP Features 

25. Completely new subsection describing VT420 OLTP features. 

Saving and Restoring Terminal State 

26. Terminal State Interrogation: Completely new subsection 
describing TSI 

27. Modified note on DECCIR (Cursor Information Report) to 
specify sequence returns UPSS designator if G-set was 
designated that way. 

Internal Functions and Procedures 

28. Modified routines scroll_up and scroll_down to operate 
within the left and right margins . 

29. Added routines scroll_left and scroll_right . 

Control Function Reference to Other Chapters 
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30. Completely new subsection listing control functions and 
what chapter of the VSRM they are described in . 
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5.17 REFERENCE STANDARDS 
DIGITAL STANDARDS 

EL-00138-00 DEC STD 138 Registry of Control 

Functions for Character- Imaging Devices 

EL-00169-00 DEC STD 169 Digital Standard Coded 

Graphic Character Sets for Hardware 
and Software 

Copies of Digital Standards Can be obtained from Standards and 
Methods Control, CTS1-2/D4, DTN 287-3724, JOKUR::SMC 


ANSI AND ISO STANDARDS 

ANSI X3 . 4 - 1986 American National Standard Code for 

Information Interchange (ASCII character set) 

ANSI X3.41 - 1974 American National Standard Code Extension 

Techniques for use with the 7-Bit Coded 
Character Set of the American National 
Standard Code for Information Interchange 

ANSI X3.64 - 1979 Additional Controls for use with American 

National Standard Code for Information 
Interchange 

dpANS X3 . 134 . 1-1985 8-bit ASCII Structure and Rules 

dpANS X3 . 134 . 2-1985 7-bit and 8-bit ASCII Supplemental 

Multinational Graphic Character Set 

ISO 646 7-Bit Coded Character Set 

for Information Interchange 

ISO 2022:1986 Information Processing / 

ISO 7 -Bit and 8 -Bit Coded Character Sets - 
Code Extension Techniques 

ISO 6429:1988 Information Processing / 

Additional Controls for use with 
Character Imaging Devices 

ISO 8859-1:1987 Information Processing / 

8-Bit Single-Byte Coded Character Sets - 
Part 1 : ISO Latin Alphabet Nr 1; 

Copies of ANSI and ISO Standards can be obtained from local 
Digital Libraries . 



VSRM - Character Cell Display EL-00070-05 Page 5-226 

Digital Internal Use Only - For Review Only 29-Jun-1990 


Section Index 


Active Position, 5-20 
definition, 5-9 
Alternative Text Rendition 
Mapping, 5-113 
Application 

definition, 5-9 
Application Program 
definition, 5-9 
ASCII, 5-115 
Assign User-Preference 

Supplemental Set, 5-123 
Audible Indicator 
definition, 5-10 
Audible Indicators, 5-114 

Back Index 

control function, 5-39 
Back Space 

control function, 5-63 
BEL, 5-114 
Bell 

definition, 5-10 
8-bit Architecture Extension, 
5-115 

8-bit Multinational Characters, 
5-126 

7-bit NRCS Characters, 5-126 
Blink Rendition, 5-101 
Bold Rendition, 5-101 
Bottom Margin, 5-25 
default value, 5-25 
BS, 5-63 

Carriage Return 

control function, 5-58 
Change Attributes Rectangular 
Area 

control function, 5-173 
Character 

attribute, 5-165 
rendition, 5-101 
Character Attribute, 5-165 
definition, 5-10 
normal, 5-165 
selection, 5-166 
selectively erasable, 5-165 
Character Cell, 5-19 
Character Cell Display 
definition, 5-6 
Character Imaging Device 
definition, 5-10 


Character Position, 5-19 
definition, 5-10 
Character Rendition 
definition, 5-10 
Character Set 

designation, 5-117 
Character Set Mode, 5-126 
Character Set Selection 
DECNRCM, 5-126 
UPSS, 5-123, 5-125 
Character Sets, 5-115 
Checksum Report, 5-181 
Color Table Report, 5-109 
Color Table Request, 5-109 
Color Table Restore, 5-109 
Color Text Extension, 5-106 
Column, 5-19 

132-Column Extension, 5-19, 5-71 
Column Mode 

control function, 5-71 
Control Code 

back index, 5-39 
back space, 5-63 
carriage return, 5-58 
form feed, 5-62 
forward index, 5-37 
horizontal tab, 5-67 
horizontal tabulation set, 5-69 
index, 5-34 
line feed, 5-59 
next line, 5-64 
reverse index, 5-36 
substitute, 5-132 
vertical tab, 5-61 
Control Codes 

warning bell, 5-114 
Copy Rectangular Area 
control function, 5-169 
CPR, 5-53 
CR, 5-58 
CUB, 5-47 
CUD, 5-43 
CUF, 5-45 
CUP, 5-49 
Cursor, 5-20 

definition, 5-10 
Cursor Backward 

control function, 5-47 
Cursor Control 
definition, 5-11 
Cursor Down 
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control function, 5-43 

DECPCCM, 5-87 


Cursor Forward 

DECPSR, 5-199 


control function, 5-45 

DECRARA, 5-175 


Cursor Information Report, 

5-200 DECRC, 5-189 


Cursor Movement 

DECRPDE, 5-88 


cursor backward, 5-47 

DECRPM, 5-195 


cursor down, 5-43 

DECRPSS, 5-197 


cursor forward, 5-45 

DECRQCRA, 5-179 


cursor position, 5-49 

DECRQDE, 5-88 


cursor position report. 

5-53 DECRQM, 5-193 


cursor up, 5-41 

DECRQPSR, 5-198 


extended cursor position 

report, DECRQSS, 5-196 


5-55 

DECRQTSR, 5-206 


horizontal/vertical position, DECRQUPSS, 5-125 


5-51 

DECRSPS, 5-205 


Cursor Position 

DECRSTS, 5-208 


control function, 5-49 

DECSACE, 5-177 


Cursor Position Report 

DECSC, 5-187 


control function, 5-53 

DECSCA, 5-166 


Cursor Save and Restore 

DECSCLM, 5-32 


restore cursor, 5-189 

DECSCNM, 5-94, 5-107 


save cursor, 5-187 

DECSCPP, 5-73 


Cursor Save Buffer, 5-186 

DECSED, 5-162 


Cursor Symbol, 5-21 

DECSEL, 5-159 


definition, 5-10 

DECSERA, 5-172 


Cursor Up 

DECSLPP, 5-75 


control function, 5-41 

DECSLRM, 5-27 


CUU, 5-41 

DECSNLS, 5-89 

DECSTBM, 5-25 


DCH, 5-144 

DECSTGLT, 5-113 


DEC STD 169, 5-225 

DECSWL, 5-96 


DEC Supplemental, 5-115 

DECTABSR, 5-204 


DEC Technical, 5-115 

DECTCEM, 5-21 


DECAUPSS, 5-123 

DECTSR, 5-207 


DECBI, 5-39 

DECVCCM, 5-86 


DECCAE^, 5-173 

DECXCPR, 5-55 


DECCIR, 5-200 

Default 


DECCKSR, 5-181 

definition, 5-11 


D]SCCOLM, 5-71 

left and right margins. 

5-27 

DECCRA, 5-169 

scrolling region, 5-25, 

5-27 

DECCTR, 5-109 

top and bottom margins. 

5-25 

DECDC, 5-151 

default colors, 5-110 


DECDHLB, 5-99 

Define Macro 


DECDHLT, 5-99 

control function, 5-182 


DECDMAC, 5-182 

Delete 


DECDWL, 5-97 

character, 5-144 


DECERA, 5-171 

definition, 5-11 


DECFI, 5-37 

line, 5-148 


DECFRA, 5-170 

Delete Character 


DECHCCM, 5-85 

control function, 5-144 


DECIC, 5-150 

Delete Column 


DECINVM, 5-184 

control function, 5-151 


DECMSR, 5-185 

Delete Line 


DECNRCM, 5-126 

control function, 5-148 


DECOM, 5-29, 5-31 

Designate 
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character set, 5-117 
definition, 5-11 
Designate Character Set 
control function, 5-117 
Device Status Report 
memory checksum, 5-180 
Display, 5-19 

definition, 5-11 
Display Attributes 

select character attribute, 
5-166 

select graphic rendition, 5-103 
DL, 5-148 

Double Height Line, 5-95 
control function, 5-99 
Double Width Line, 5-95 
control function, 5-97 
dpANS X3. 134. 1-1985, 5-225 
DRCS, 5-115 
DSR, 5-180 

macro space report, 5-185 

ECH, 5-152 
ED, 5-156 
Editor Function 
definition, 5-11 
EL, 5-154 
Empty Character 
definition, 5-11 
End Of Line 

internal function, 5-209 
Enter 

definition, 5-11 
Erase 

character, 5-152 
definition, 5-11 
in display, 5-156 
in line, 5-154 

(selective) in display, 5-162 
(selective) in line, 5-159 
Erase Character 

control function, 5-152 
Erase In Display 

control function, 5-156 
Erase In Line 

control function, 5-154 
Erase Rectangular Area 
control function, 5-171 
Extended Cursor Position Report 
control function, 5-55 
Extension 

Color Text, 5-106 
132-Column, 5-19 
132-column, 5-19, 5-71 
Horizontal Scrolling, 5-23 


Level 1, 5-19 
Level 2, 5-19 

FF, 5-62 

Fill Rectangular Area 
control function, 5-170 
Fixed Space 

definition, 5-11 
Font 

definition, 5-11 
Form Feed 

control function, 5-62 
Format Effector 
definition, 5-11 
Forward Index 

control function, 5-37 

G-Sets, 5-118 
GO, 5-118 
Gl, 5-118 
G2, 5-118 
G3, 5-118 
GL, 5-118 
GR, 5-118 
Graphic Character 
definition, 5-12 
insertion, 5-139 
replacement, 5-139 
Graphic Rendition, 5-101 
blink, 5-101 
bold, 5-101 
definition, 5-12 
normal, 5-101 
reverse, 5-102 
selection, 5-103 
underscore, 5-102 
Graphic Symbol 
definition, 5-12 

Horizontal Cursor Coupling Mode 
control function, 5-85 
Horizontal Scrolling 
Extension, 5-23 
Horizontal Tab 

control function, 5-67 
Horizontal Tabulation, 5-65 
clearing, 5-66 
default, 5-65 
Horizontal Tabulation Set 
control function, 5-69 
Horizontal/Vertical Position 
control function, 5-51 
HT, 5-67 
HTS, 5-69 
HVP, 5-51 
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ICH, 5-142 
IL, 5-146 

In Use Table, 5-118 

IND, 5-34 

Index 

control function, 5-34 
indexed color, 5-107 
Insert 

character, 5-142 
Insert Character 

control function, 5-142 
Insert Column 

control function, 5-150 
Insert Line 

control function, 5-146 
Insert /Replacement Mode 
control function, 5-138 
Insertion 

character, 5-139 
Interfaces 

external, 5-8 
internal, 5-8 
Internal Functions 
end of line, 5-209 
scroll down, 5-211 
scroll left, 5-212 
scroll right, 5-213 
scroll up, 5-210 
Invoke 

definition, 5-12 
Invoke Macro 

control function, 5-184 
IRM, 5-138 
ISO 8859-1, 5-225 
ISO Latin-1 Supplemental, 5-115 


Macro Space Report, 5-185 
DSR, 5-185 
Margin 

definition, 5-12 
Margins, 5-23 
Memory Checksum 
DSR, 5-180 
Modes, 5-133 
column, 5-71 
definition, 5-12 
Horizontal Cursor Coupling, 
5-85 

insert /replacement , 5-138 
Left Right Margin, 5-29 
new line, 5-57 
origin, 5-31 

Page Cursor Coupling, 5-87 
screen, 5-94 
scrolling, 5-32 
Send-Receive, 5-135 
text cursor enable, 5-21 
Vertical Cursor Coupling, 5-86 

National Replacement Character 
Set Mode, 5-126 
NEL, 5-64 

New Line Mode, 5-57 

control function, 5-57 
Next Line 

control function, 5-64 
Next Page 

control function, 5-77 
Normal Rendition, 5-101 
NP, 5-77 
NRCS, 5-115 

Operating System 
definition, 5-12 
Origin Mode 

control function, 5-31 


Left Margin, 5-27 

default value, 5-27 
Left Right Margin Mode 
control function, 5-29 
LF, 5-59 
Line, 5-19 

definition, 5-12 
rendition, 5-95 
Line Drawing, 5-115 
Line Feed 

control function, 5-59 
Line Rendition, 5-95 

double -height line, 5-99 
double-width line, 5-97 
single-width line, 5-96 
LNM, 5-57 

Logical Display, 5-19, 5-70 
definition, 5-12 


Page, 5-19 

definition, 5-12 
Page Arrangement, 5-70 
Page Cursor Coupling Mode 
control function, 5-87 
Page Position Absolute 
control function, 5-81 
Page Position Backward 
control function, 5-83 
Page Position Relative 
control function, 5-82 
Page Size, 5-19, 5-70 
Pan Down, 5-91 
Pan Up, 5-92 
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PP, 5-79 

PPA, 5-81 

PPB, 5-83 
PPR, 5-82 
Preceding Page 

control function, 5-79 
Presentation State Report, 5-199 

Received Data Stream 
definition, 5-13 
Reference Standards, 5-225 
ReGIS, 5-112 
Replacement 

character, 5-139 
Report Displayed Extent, 5-88 
Report Mode, 5-195 
Report Selection or Setting, 

5-197 

Request Checksum of Rectangular 
Area 

control function, 5-179 
Request Displayed Extent, 5-88 
Request Mode, 5-193 
Request Presentation State Report, 
5-198 

Request Selection or Setting, 

5-196 

Request Terminal State Report, 
5-206 

Request User-Preference 

Supplemental Set, 5-125 
Reset Mode 

column, 5-71 

Horizontal Cursor Coupling, 

5-85 

insert/replacement , 5-138 
Left Right Margin, 5-29 
new line, 5-57 
origin, 5-31 

Page Cursor Coupling, 5-87 
screen, 5-94 
scrolling, 5-32 
send receive mode, 5-135 
text cursor enable, 5-21 
Vertical Cursor Coupling, 5-86 
Restore Cursor 

control function, 5-189 
Restore Presentation State, 5-205 
Restore Terminal State, 5-208 
Reverse Attribute, 5-112 
Reverse Attributes Rectangular 
Area 

control function, 5-175 
Reverse Index 

control function, 5-36 


Reverse Rendition, 5-102 
RI, 5-36 

Right Margin, 5-27 
default value, 5-27 

Save Cursor 

control function, 5-187 
Screen Mode 

control function, 5-94 
Scroll 

definition, 5-13 
Scroll Down, 5-92 

internal function, 5-211 
Scroll Left 

internal function, 5-212 
Scroll Right 

internal function, 5-213 
Scroll Up, 5-91 

internal function, 5-210 
Scrolling, 5-23 
Scrolling Mode 

control function, 5-32 
Scrolling Region, 5-23, 5-25, 

5-27, 5-31, 5-32 
default value, 5-25, 5-27 
SD, 5-92 

Select Attribute Change Extent 
control function, 5-177 
Select Character Attribute 
control function, 5-166 
Select Graphic Rendition 
control function, 5-103 
Select Number of Lines per Screen, 
5-89 

Select Text /Graphics Look-Up 
Table, 5-113 

Selective Erase In Display 
control function, 5-162 
Selective Erase In Line 
control function, 5-159 
Selective Erase Rectangular Area 
control function, 5-172 
Selectively Erasable Characters, 
5-165 

Send-Receive Mode 

control function, 5-135 
Service Class 

character cell display, 5-6 
Set Columns Per Page 
control function, 5-73 
Set Left and Right Margins 
control function, 5-27 
Set Lines Per Page 

control function, 5-75 
Set Mode 
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column, 5-71 

Horizontal Cursor Coupling, 

5-85 

insert /replacement , 5-138 
Left Right Margin, 5-29 
new line, 5-57 
origin, 5-31 

Page Cursor Coupling, 5-87 
screen, 5-94 
scrolling, 5-32 
send receive mode, 5-135 
text cursor enable, 5-21 
Vertical Cursor Coupling, 5-86 
Set Top and Bottom Margins 
control function, 5-25 
SGR, 5-103, 5-106, 5-107 
Single Width Line, 5-95 
control function, 5-96 
Sixels, 5-112 
Software Conformance 

designate character sets, 5-118 
double-height lines, 5-95, 5-99 
horizontal/vertical position, 
5-51 

new line mode, 5-57 
screen mode, 5-94 
SRM, 5-135 
String Delimiter 
definition, 5-13 
SU, 5-91 
SUB, 5-132 
Substitute 

control function, 5-132 

Tabulation 

clearing, 5-66 
definition, 5-13 
horizontal, 5-65 
stop, 5-13 

Tabulation Clear, 5-66 
control function, 5-66 
Tabulation Stop 
definition, 5-13 
Tabulation Stop Report, 5-204 
Tabulation Stops 
clearing, 5-66 
default, 5-65 
horizontal, 5-65 
TBC, 5-66 

Terminal State Report (1) , 5-207 
Text Cursor Enable Mode 
control function, 5-21 
Top Margin, 5-25 

default value, 5-25 
Transmit 


definition, 5-13 
Transmitted Data Stream 
definition, 5-13 
TSI, 5-109 

cursor information report, 

5-200 

Presentation State Report, 

5-199 

report mode, 5-195 
report selection or setting, 
5-197 

request Mode, 5-193 
request presentation state 
report, 5-198 

request selection or setting, 
5-196 

request terminal state report, 
5-206 

restore presentation state, 
5-205 

restore terminal state, 5-208 
tabulation stop report, 5-204 
terminal state report (1) , 

5-207 

UK set, 5-115 

Underscore Rendition, 5-102 
UPSS, 5-123, 5-125 
User-Preference Supplemental Set, 
5-123, 5-125 

Vertical Cursor Coupling Mode 
control function, 5-86 
Vertical Tab 

control function, 5-61 
VT, 5-61 


Warning Bell 

control function, 5-114 
Windowing Extension 
DECHCCM, 5-85 
DECPCCM, 5-87 
DECRQDE/DECRPDE, 5-88 
DECSCPP, 5-73 
DECSLPP, 5-75 
DECVCCM, 5-86 
DECXCPR, 5-55 
NP, 5-77 
PP, 5-79 

PPA, 5-81 

PPB, 5-83 
PPR, 5-82 
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ABSTRACT: This specification describes the interfaces to 

terminals using the Digital Standard Keyboard of 1980 (Level 1) 
and the corporate standard keyboard (LK201 and future) (Level 2 
and Level 3). It specifies both the coding interface between the 
application program and the terminal and the human interface 
between the terminal user and the keyboard. Furthermore, the same 
coding interface is provided to the application program whether it 
is running in a host computer or inside a personal computer or 
workstation, thereby achieving transportability of application 
programs. 


APPLICABILITY: Mandatory for engineers designing hardware for 

terminal products and software engineers designing programs using 
terminal interfaces. Additional requirements are defined in the 
section on "Concepts and Conformance Criteria". 
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6.1 INTRODUCTION 

6.1.1 Keyboard Overview 

The terminal interface described in this specification applies 
specifically to handlln<g of the LK201 corporate standard keyboard 
and all future corporate standard keyboards. 

Logically, the keyboard is part of the terminal; however, it is 
physically and electrically packaged separately. This 
specification does not specify the interface between the keyboard 
and the rest of the terminal. That interface is described in full 
in the LK201 Functional Specification. 

This specification describes the keyboard layouts for two 
different product classes; 

1. LK201- { Ax, Ex, Nx } DEC Standard Keyboard 

2. LK201- { Bx, Fx, Px } DECmate/WPS 

The physical layout is the same; only the key legends and the 
Permanent Label Strip differ between the product classes. 

Keyboards operate in one of two usage modes; typewriter or data 
processing which changes the meaning of a small number of keys as 
indicated by dual legends on the key cap. Some keyboards are used 
for both typewriter and data processing with the same legends. 
Differences between these modes are examined in detail in the 
tables of the Main Key Array section. 
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6. 1.1.1 Keyboard Product Classes - 

The Digital Standard keyboard product class includes the LK201- 
{Ax, Ex, Nx}. The "E" designation, as in LK201- Ex, is used 
because letter variations for "Ax" were exhausted. The "Ex" 
subfamily consists of upgraded keyboards which have a predecessor 
in the "Ax" subfamily and also keyboards which are entirely new 
and have no predecessor in the "Ax" subfamily. Examples of the 
former are the LK201- ED, LK201- AD Danish Keyboard and the LK201- 
EN, LK201- AN Norwegian Keyboard. Examples of keyboards with no 
predecessor in the "Ax" subfamily are the LK201- EH, Greek, and 
the LK201- ER Arabic Keyboards. 

The LK201- Nx subfamily is for the VT300 series terminals. The 
LK201- NA is unique in that it has front legends on the numeric 
and editing keypads that other LK201 keyboards do not. In detail, 
the LK201- {NA, NF, NH) are to be used with the VT330/340 series 
and the LK201- (NG, NM, NX} are to be used with the VT320 series 
terminals. 

The DECmate/WPS keyboard product class includes the LK201- (Bx, 

Fx, Px}. The "F" designation, as in LK201- Fx, is used because 
letter variations for "Bx" were exhausted. The LK201- Px is used 
with the VT300 series terminals. 
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6. 1.1. 2 Keyboard Versions And Dialects - 

I 

I The LK201 is manufactured in a number of versions to accomodate 
I local language and application specific requirements. These 
versions differ only in the labeling of keys and visual 
indicators. To the terminal system all the keyboards will appear 
identical. With the exception of the Main Key Array, the codes 
transmitted by the terminal for all key positions are the same for 
all versions of the keyboard and the only differences are the 
languages of the legends and label strips. 

I Digital terminals support a number of keyboard layouts 
I corresponding to different keyboard versions. Within the 
I terminal, these different layouts are actually different mappings 
I from keystrokes on the main key array to character codes produced, 

I and are called "Keyboard Dialects". The terminal user selects the 
I desired Keyboard Dialect in Set-Up, usually corresponding to the 
I keyboard version. It is this selection of Keyboard Dialect that 
I controls the characters produced for a given series of keystrokes, 

I not the physical keyboard layout. The names of the Keyboard 
I Dialects are based on the geographical region, country, or 
I language for which the keyboard is primarily intended. 

I The following is a list of the Keyboard Dialects and corresponding 
I keyboard versions or layouts defined within this specification. 

I Some of the dialects have changed to accomodate more recent 
1 country requirements. The most recent or recommended variation 
within each dialect is listed first. 
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Keyboard Dialect Version 


North American 

British 

Flemish (Belgium) 
Canadian (French) 
Danish 

Finnish 

Austrian/German 

Dutch 

Italian 

Swiss (French) 
Swiss (German) 
Swedish 

Norwegian 

Belgian/French 

Spanish 

Portuguese 


LK201-EE 

LK201-NA 

LK201-AA 

LK201-EE 

LK201-AE 

LK201-AB 

LK201-AC 

LK201-ED 

LK201-AD 

LK201-NX 

LK201-NF 

LK201-AF 

LK201-NG 

LK201-AG 

LK201-NH 

LK201-AH 

LK201-AI 

LK201-AK 

LK201-AL 

LK201-NM 

LK201-AM 

LK201-EN 

LK201-AN 

LK201-AP 

LK201-AS 

LK201-AV 


Combined U.S./U-K- (VT320, VT220CR) 
Combined U.S./U.K. (VT330/VT340 
with local editing legends) 

1st U.S. (VT200) 

Combined U.S./U»K* 

1st U.K. (VT200) 

Same as Belgian/French (LK201-AP) 


2nd Danish (VT300) 

1st Danish (VT200) 

3rd Finnish (VT320) 

2nd Finnish ( VT330/VT340 ) 

1st Finnish (VT200) 

Same as 1st Swedish (LK201-AM) 

2nd Austrian/German (VT300) 

1st Austrian/German 

2nd Dutch (VT320) 

Same as North American (LK201-EE) 
1st Dutch 


2nd Swedish (VT300) 

1st Swedish 

Same as 1st Finnish (LK201-AF) 

2nd Norwegian (VT300) 

1st Norwegian 

Same as Flemish (LK201-AB) 
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Notes: 

1. Many keyboards can be ordered with or without country 
power cords (to form "country kits"). The following 
keyboard series are generally equivalent: 

W/PWR Keyboard 
Cord Alone 


Ax - Lx 
Bx - MX 
Ex » Rx 

This specification uses the keyboard with power cord 
designations (most common on video terminals) wherever 
possible . 

2. WPS or Gold keyboard layouts add gold legends to the 

alpha-numeric layouts above. Gold layouts corresponding 
to the keyboard versions above, where -Ax is regular, and 
-Bx is WPS, are: 


-BA 

to 

AA, 

-BB 

to 

AB, 

-BC 

to 

AC, 

-BD 

to 

AD, 

-BE 

to 

AE, 

-BF 

to 

AF, 

-BG 

to 

AG, 

-BH 

to 

AH, 

-BI 

to 

AI, 

-BK 

to 

AK, 

-BL 

to 

AL, 

-BM 

to 

AM, 

-BN 

to 

AN, 

-BP 

to 

AP, 

-BS 

to 

AS, 

-PE 

to 

EE, 

-PA 

to 

NA. 
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6.1.2 Scope 

This specification defines the coding interface between terminals 
and software application processes and the logical part of the 
human interface between the keyboard and the terminal user. 

The coding interface is defined to be the hardware or software 
interface across which coded control functions and graphic 
characters are passed. The same coding interface shall exist: 

1. Between a fixed function terminal and a host computer. 

2. Between a personal computer/workstation simulating a 
fixed function terminal and a host computer. 

3. Between a personal computer/workstation and an 
application program running inside the personal 
computer/workstation. 

By making the coding interface the same in the above three 
situations, transportability of application programs is possible. 

This specification also defines the logical part of the interface 
between the keyboard and the terminal user not covered in any 
section of DEC STD 107 Digital Standard for Terminal Keyboards and 
its revisions, specifically the operation of the Compose key and 
Non-Spacing Diacritical keys for all national keyboards. 
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6.1.3 Relationship To TIA 

The Keyboard Processing interface forms a service class of the 
Input Processing layer of the Terminal Interface Architecture. It 
is backwards compatible at the coding interface with the Level 1 
Keyboard previously described in DEC STD 107-0, of which it is a 
complete super set. 


TERMINAL USER 

*********************** Human interface 


I I I Keyboard ( | Input Processing 

I I I Processing j j 



Presentation 
Service Class 


Code Extension 
Layer 


*********************** Coding Interface 

APPLICATION PROCESS 


Structuring of the Terminal Interface Architecture 
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6.1.4 Coding Interface 

The coding interface defined within this specification applies to 
both internal and external product interfaces. External 
interfaces are interfaces between a terminal, personal computer or 
workstation and a remote system. Internal interfaces are 
interfaces between a terminal sub-system and software application 
processes running within a personal computer or workstation. An 
application process consists of the following software components: 
terminal driver, operating system, layered application subroutine 
package, and the application program. This specification does not 
deal with which of these components convert the coded information 
to other forms, if any, before it is processed by the application 
program. 


|. keyboard 1 

* 

. * 

. terminal system * host system 

- * 

I I * I I 

I physical | virtual * | application | 

I terminal | terminal * j process j 

! I * II 

* 

<hardware>* <firmware> * <communications link> <software> 

* 

★ 

* EXTERNAL CODING INTERFACE 


I keyboard | 

* . 

I * 

I terminal system 

* 

I * I 

physical | virtual * application | 

terminal j terminal * process j 

I * I 

* 

<hardware> <software/ * <software> 

firmware> * 

* 

* INTERNAL CODING INTERFACE 



External and Internal Terminal Coding Interfaces 
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6.2 CONFORMANCE REQUIREMENTS 

I All conforming terminal keyboard implementations will provide at 
I least two compatibility levels, or modes of operation (part of 
I terminal conformance level). Level 1 provides backward 

compatibility with previous keyboards designed in conformance with 
DEC STD 107 (VTlOO, LA36, and SO on) and provides the 7-bit ASCII 
control and graphic characters. Level 2 is a compatible super set 
of Level 1 and provides the 8-bit DEC STD 169 Multinational 
Character Set , the Editing Keypad, and the Application Function 
I Keys. Level 3 is a compatible super set of Level 2 which offers 
I more flexible control over the keyboard encoding (ISO Latin 
I Alphabet Nr. 1, DECKBUM to switch between Typewriter and Data 
I Processing Mode). 

A terminal conforming to Level 1 shall be able to transmit to a 
7-bit host communication port and may optionally provide a local 
Set-Up feature to transmit to an 8-bit host port (with the 8th bit 
always zero). A terminal conforming to Level 2 shall provide a 
local Set-Up feature to transmit to a 7-bit or 8-bit host 
communication port. 

A terminal conforming to Level 2 shall be able to switch to Level 
1 operation. When a Level 2 terminal is operating in Level 2 mode 
and 7-bit host communication port mode, only a subset of Level 2 
functionality shall be transmitted. 
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6.2.1 Level 1 Conformance Requirements 

Terminals, workstations, and personal computers conforming to 
Level 1: 


a. Shall implement all keys indicated in Level 1 Operation. 

b. Shall neither implement additional keys nor make 
operative keys that are not part of Level 1 Operation. 

c. Shall make inoperative all keys that are part of Level 2 
operation only. 

d. Shall implement the following control functions for 
receipt from software application processes and as a 
local Set-Up feature: 

1. Auto Repeat Mode (DECARM) 

2. Cursor Key Mode (DECCKM) 

3. Keypad Mode ( DECKPAM/DECKPNM) 

4. Line Feed/New Line Mode - see the chapter "Character 
Cell Display" 


e. Shall implement the following control function for 
receipt from software application processes: 

- Keyboard Action Mode (KAM) 


f. Shall implement the following local Set-Up features: 

- Caps/Shift Lock Mode as Caps Lock Operation; may 
optionally implement a local Set-Up feature to change 
the mode to Shift Lock Operation. 

- May optionally provide means to switch Host Port 
Environment Mode to 8-bits. 
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6.2.2 Level 2 Conformance Requirements 

Terminals, workstations, and personal computers conforming to 
Level 2: 


a. Shall implement all keys indicated in Level 2 Operation. 

b. Shall implement no additional keys. 

c. Hay implement the 8-bit Architecture Extension. 

d. May implement the NRCS Extension. 

e. Shall implement the following control function for 
receipt from a software application process and as local 
Set-Up features: 

- All Level 1 control functions. 


f. Shall implement the following control functions for 
receipt from a software application process: 

1. All Level 1 functions. 

2. Select Conformance Level (DECSCL) to switch between 
Level 1 Operation and Level 2 Operation. 


g. Shall implement the following local Set-Up features: 

1. Keyclick Mode. 

2. Caps/Shift Lock Mode. The terminal user shall be 
able to set the Caps/Shift Lock Mode to either Caps 
Lock Operation or Shift Lock Operation. The factory 
default shall be Caps Lock Operation. 

3. May optionally implement means to disable the 
"warning bell", or "margin bell" indicator as a Level 
2 extension. 

4. May optionally implement additional local Set-Up 
features not specified by the architecture, for 
example, volume of bell, volume of keyclick. 
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6.2.3 Level 3 Conformance Requirements 

All Level 2 conformance requirements plus the following: 

a. Shall implement the 8-bit Architecture Extension. 

b. Shall implement the following control function for 
receipt from a software application process and as local 
Set-Up features: 

- Keyboard Usage Mode (DECKBUM) to select between 
Typewriter and Data Processing keys. 


c. Shall implement the following control function for 
receipt from a software application process: 

- Select Conformance Level (DECSCL) to switch between 
Level 1 Operation, Level 2 Operation, and Level 3 
Operation. 


d. May implement the Keypad Compose mechanism for "Composing 
Arbitrary 8-bit Characters" described later in this 
document. 
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6.2.4 Level 1 Operation 

For purposes of conformance, inoperative means that the key shall 
not transmit anything, and shall not keyclick. 

When Level 1 operation is selected, the following restrictions 
shall apply: 

a. Only 7-bit ASCII character codes shall be transmitted 
with the 8th bit omitted or zero depending on whether the 
host port environment is set to 7-bits versus 8-bits 
respectively. Keys which would normally produce an 8-bit 
code with the 8th bit set shall be inoperative. 

b. The Editing Keypad keys with generic names El, E2, E3, 

E4, E5, and E6 are inoperative. 

c. The Function keys with generic names F6, F7 , F8, F9, and 
FlO are inoperative. 

d. Function key with generic name Fll shall transmit the ESC 
code ( 1/11 ) . 

e. Function key with generic name Fl2 shall transmit the BS 
code ( 0/8 ) . 

f. Function key with generic name F13 shall transmit the LF 
code' ( 0/10 ) . 

g. Function keys with generic names Fl4, Fl5, Fl6, F17, F18, 
Fl9, and F20 are inoperative. 

h. The only valid Compose sequences shall be those which 
generate 7-bit ASCII character codes. Those sequences 
that would produce an 8-bit code with the 8th bit set, 
shall not transmit anything, and shall echo the error 
bell after the final key stroke of the sequence. 
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I 6.2.5 Level 2 And Level 3 Operation 

I 

When Level 2 or Level 3 operation is selected and the Host Port 
Environment Mode is set to 8-bits, the following conditions shall 
apply: 

a. All keyboard keys are live. 

b. The Function keys with generic names Fll, F12, and F13 
transmit their designated control sequences (i.e., ESC, 
BS, and LF can only be generated as control character 
combinations from the main key array). 

c. All valid 7-bit and 8-bit Compose sequences may be typed 
by the terminal user. 

d. No additional Compose sequences for existing or new 
characters may be typed by the terminal user. 

When Level 2 or Level 3 operation is selected and Host Port 
Environment Mode is set to 7-bits, the following conditions shall 
apply: 


o Shall make inoperative all explicit or implied compose 
sequences that would generate an 8-bit code with the 8th 
bit one. 

o Shall transmit all explicit or implied compose sequences 
that would generate an 8-bit code with the 8th bit zero. 
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6.2.6 Keyboard Character Encoding 

In Level 1 operation the keyboard shall transmit ASCII from GL, no 
supplemental characters are available. 

In Level 2 operation the keyboard shall transmit ASCII from GL and 
the DEC Supplemental Set from GR. 

If the Level 2 8-Bit Architecture Extension is supported (refer to 
DEC STD 070-3 Code Extension Layer ) , the keyboard shall transmit 
ASCII from GL and the User Preference Supplemental Set (UPSS, DEC 
Supplemental or ISO Latin-1) from GR (same as Level 3 operation 
below) . 

In Level 3 operation the keyboard shall transmit ASCII from GL and 
the User Preference Supplemental Set (UPSS, DEC Supplemental or 
ISO Latin-1) from GR. 

Level 3 terminals, and Level 2 terminals with the 8-bit 
Architecture Extension, support at least two different 8-bit 
multinational character encodings. Level 2 and Level 3 terminals 
with the NRCS Extension also support a number of 7-bit country 
specific (National) character encodings. At any time, only one of 
these character encodings is in use. No character set shift 
functions (SO, SI, etc.) will be transmitted as a side effect of 
typing a keyboard key (except if ctrl-N or ctrl-0 are explicitly 
typed). The user can choose one of the following keyboard 
encodings via Set-Up: 

- DEC Multinational (factory default) 

SET-UP: 8-bit Characters, UPSS DEC Multinational 

Primary keyboard set is ASCII 

Supplemental keyboard set is DEC Supplemental 

- ISO Latin Alphabet Nr 1 

SET-UP: 8-bit Characters, UPSS ISO Latin-1 

Primary keyboard set is ASCII 

Supplemental keyboard set is ISO Latin-1 supplemental 

- 7-bit ASCII character set 

SET-UP: 7-bit Characters, Data Processing Keys 

Primary keyboard set is ASCII 
No supplemental characters available 

- 7-bit National Replacement Character Set (NRCS) 

SET-UP: 7-bit Characters, Typewriter Keys 

Primary keyboard set is one of 12 NRCS 
No supplemental characters available 

The selection of a particular 7-Bit NRCS is bound to the selection 
of the keyboard dialect. See guideline under heading "Keyboard 
Dialect". In 7-bit Characters mode, choosing Data Processing Keys 
always uses ASCII as the primary keyboard set. 
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Deviation Note 

Older Level 2 terminals with the NRCS Extension 
did not always use ASCII as the primary keyboard 
set when Data Processing Keys was selected (prior 
to the VT220CR). This use of a 7-bit NRCS other 
than ASCII in 7-bit Characters Data Processing 
mode has been deprecated. 


Explanatory Note 

The character set mode, 7-bit/8-bit Characters 
corresponds to National/Multinational Mode (NRCS 
Extension) on the VT200 but with two 
simplifications. 8-bit Characters are temporarily 
disabled when in "VTlOO mode", or a "7-bit host 
line" is selected. 

In practice, this means the terminal no longer 
supports ASCII with the Typewriter Keys layout 
except on the North American Keyboard. This makes 
sense. The typewriter layout has no inherent 
advantage when using ASCII, it simply has more 
dead keys. Confusing distinctions like VTlOO 
Multinational mode have been eliminated. 


The remainder of this specification documents keyboard behavior 
with both the 8-bit Architecture and NRCS Extensions. 
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6.3 REFERENCED STANDARDS AND RELATED PUBLICATIONS 
DIGITAL STANDARDS 

I DEC STD 070-3 Code Extension Layer 

I DEC STD 070-4 Terminal Management 

I DEC STD 070-7 Printer Port Extension 

I DEC STD 070-12 Terminal Synchronization 

I EL-00107-00 DEC STD 107-0 Digital Standard for Terminal 

I Keyboards Standard Keyboard Layouts 

EL-00138-00 DEC STD 138-0 Registry of Control 

Functions for Character-Imaging Devices 

I EL-00169-00 DEC STD 169-0 Digital Standard Coded 

I Graphic Character Sets for Hardware 

I and Software 

A-SP-LK200-A-0 LK200 Functional Specification 

A-SP-LK201-A-2 LK201 Keyboard Design Specification 

Copies of Digital Standards Can be obtained from Standards and 
Methods Control, CTS1-2/D4, DTN 287-3724, JOKUR::SMC 

Please provide your name, badge number, cost center, mailstop, and 
ENET node when ordering. 


ANSI AND ISO STANDARDS 

ANSI X3.4 - 1986 American National Standard Code for 

Information Interchange (ASCII character set) 

ANSI X3.41 - 1974 American National Standard Code Extension 

Techniques for use with the 7-Bit Coded 
Character Set of the American National 
Standard Code for Information Interchange 

ANSI X3.64 - 1979 Additional Controls for use with American 

National Standard Code for Information 
Interchange 

ANSI X4.23 - 1982 Keyboard Arrangement for Alphanumeric 

Machines 

ISO 2022-1982 Information Processing / 

ISO 7-Bit and 8-Bit Coded Character Sets - 
Code Extension Techniques 
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ANSI AND ISO STANDARDS (continued) 

ISO 6429-1982 Information Processing / 

Additional Controls for use with 
Character Imaging Devices 

ISO 8859-1:1987 Information Processing / 

8-Bit Single-Byte Coded Character Sets - 
Part 1 : ISO Latin Alphabet Nr 1 

Copies of ANSI and ISO Standards can be obtained from local 
Digital Libraries. 
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6.4 TERMINOLOGY 


Application Label Strip - A removable label strip associated with 
an application software package that runs under control of an 
operating system or runs stand-alone. 

Application Process - The collection of software consisting of a 
terminal driver, an operating system, layered application 
subroutines or packages, and application programs running inside a 
personal computer, workstation, or host computer. 

Byte - A bit string that is operated on as a unit and whose size 
is independent of redundancy or framing techniques. In this 
specification, bytes are 7-bit or 8-bit. 

Coded Character (or more simply "Character") - The coded 
representation of a member of a coded character set used for the 
I organization, control or representation of data. Note: In ISO 
I and ANSI standards, the term "character" does not imply coding. 

I The terms "character" and "coded character" are used 
I interchangeably in this document. The term "legend" refers to the 
I unencoded character. 

Coding Interface - A software or hardware interface through which 
bytes of character-coded information are passed between terminal 
equipment and an application process across a host port or between 
terminal equipment and a printer across a printer port. 

Compose Sequence - A sequence of two or three keys used to input a 
single graphic character that may not be available as a single 
key. 

Control Character - A control function; the coded representation 
of which consists of a single byte. 

Control Function - An action that effects the recording, 
processing, transmission, or interpretation of data and that has a 
coded representation consisting of one or more bytes. 

I Non-Spacing Diacritical Key - A key with a diacritical mark as a 
I key legend that is used as the first key of a two-keystroke 
sequence to create an accented letter. 

Diacritical Mark - A symbol used in combination with the letters A 
through Z or a through z to form an accented letter or umlaut. 

Environment - The number of bits (7 or 8) used to transmit or 
receive data across a coding interface independent of framing or 
parity across a host or printer port. 
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Explicit Compose Sequence - A three-key compose sequence starting 
with the Compose key. 

Graphic Character - A character, other than a control function, 
that has a visual representation normally handwritten, printed, or 
displayed. 

Host Port - The coding interface between a terminal and an 
application process whether the application process is running 
inside the terminal or in a host computer. 

Implied Compose Sequence - A two-key compose sequence starting 
with a Non-Spacing Diacritical key. 

Inoperative - A key which does not cause the terminal to take any 
action or modify the effect of other keys. An inoperative key 
does not transmit any bytes, and does not key click. 

Key - The physical part of a keyboard that the terminal user 
presses to input control and graphic character information. 

Key Legend (or more simply "Legend") - The visual symbol embossed 
or engraved on a key. 

Key Position ID - A standard ID that identifies the physical 
position of a key on the keyboard. Note: taken from ANSI and ISO 
keyboard standards. See DEC STD 107 which specifies the physical 
interface between keyboard and the rest of the terminal. 

Keyboard Dialect - A mapping from keystrokes on the main key array 
to character codes produced. A supported keyboard layout 
(arrangement of keycap labels) corresponding to a keyboard version 
(manufactured model such as LK201-AA) . The names of Keyboard 
Dialects are based on the geographical region, country, or 
language for which the keyboard is primarily intended (example: 
North American). 

Keyboard Usage Mode - One of "Typewriter" or "Data Processing". 
Selects a variation of the keyboard layout intended for office or 
data processing use. Data processing legends appear to the right 
of the typewriter legends on those keys where they are different. 

Permanent Label Strip - A label strip that is permanently fastened 
to the keyboard in manufacturing that labels the top row of keys 
on the keyboard (Local Function Keys and Application Function Key 
Row) . 

Printer Port -The coding interface between a terminal and a 
printer. 
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Receive - To accept coded character information from an 
application process sent to a terminal across the coding 
interface. 

Removable Label Strip - A removable label strip that labels the 
top row of keys on the keyboard (Local Function Keys and 
Application Function Keys). 

Set-Up - A mode of operation of the terminal in which the terminal 
user communicates directly with the terminal to change certain 
operational modes. Note; the human interface for Set-Up mode is 
beyond the scope of this specification; only the Set-Up features 
required for conformance are specified along with some optional 
ones . 

SPACE - A character that is both 1) a graphic character with a 
visual representation consisting of the absence of a graphic 
symbol and 2) a control character that acts as a format effector 
that causes the active position to be advanced one character 
position. 

System Label Strip - A removable label strip associated with an 
operating system. 

Terminal User - The human user of the terminal (as distinguished 
from an application process or program) . 

Transmit - To- transfer coded character information from a terminal 
to an application process across the coding interface. 
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6.5 PHYSICAL KEYBOARD DESCRIPTION 

The keyboard is broken down into six distinct functional, as well 
as physical, areas. The rest of the specification is organized 
according to these areas. In the following, the key position IDs 
are indicated in parentheses: 

1. The Main Key Array (E00-E13, D0O-D12, C99-C13, B99-B11, 
A99-A09) 

2. The Cursor Keys (B16-B18, C17) 

3. The Numeric Keypad (E20-E23, D20-D23, C20-C23, B20-B22, 
A20-A23) 

4. The Editing Keypad (E16-E18, D16-D18) 

5. The Application Function Keys (G05-G23) 

6. The Local Function Keys (G99-G03) 


6.5.1 Physical Keyboard Map > 

The physical keyboard map provides a means to identify the 
physical position of keys independent of the keyboard version or 
operating mode. Each key is given a physical Key Position ID. 
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Keyboard Map by Physical Key Position ID 
Left Half - Keyboard Position Map 


|G|G|G|G1G| |G1G|G|G|G1 |G|G|G|G| 

I 99| 00| Oil 02| 03| I 05| 06 | 07 | 08| 09 | | 11| 12 | 13| 14 | 


Local Function Keys Application Function Key Row 


|E|E|E|E|E|E|E|E|E|E|E|B|E|E | 
I 00| 01| 02| 031 04| 05| 06 | 07 | 08 | 09 | 10| 11 | 12| 13 | 


|D |D|D|D|D|D|D1D|D|D|D|D1D| 
I 00 I 01) 02| 03| 04| 05| 06 1 07 1 08| 90| 10| 111 12 1 


1C|C |C|C|C|C|C1C1C|C|C|C|C|C1C 
I 99| 00 I 01| 02| 03| 04| 05| 06 | 07 | 08 | 09 | 10| 11 | 12| 13 


1 B 1 

B 1 B 1 

B 1 

B 1 

B 1 

B 1 B 1 

B 1 

B 1 

B 1 B 1 B 1 

1 99 1 

00| Oil 

02| 

031 

04 1 

05| 06| 

07 1 

08 1 

091 10| 11 1 

1 A 

|Q.o| 1 

h 

TO 

A 



(to 1 

10 1 

1 99 

I Af-Ti, ] 



09 

fiojL 




Main Key Array 


Right Half - Keyboard Position Map 


Editing 

Keypad 


Cursor 

Keypad 


1 G 1 

G 

1 

1 G 1 

G 1 

G 1 

G 1 


1 15| 

16 

1 

1 20| 

21 1 

22| 

231 


.. Application 

Function Key Row 

( cont 

. ) 

• . . . 


1 E 1 

E 1 

E 1 

1 E 1 

E 1 

E 1 

E 1 


1 16 1 

17 1 

18| 

1 20| 

21| 

22| 

23| 


1 D 1 

D 1 

D 1 

1 D 1 

D 1 

^ 1 

D 1 


1 161 

171 

18 1 

1 201 

21| 

22 1 

23 1 


1 

c 1 


1 c 1 

c 1 

c 1 

c 1 

Numeric 

1 

17| 


1 20 1 

21| 

22| 

23 1 

Keypad 

1 B 1 

B 1 

B 1 

1 B 1 

B 1 

B 1 

1 


1 16| 

17 1 

18| 

1 20| 

21 1 

22 1 

1 

1 





1 A 

i 

A 1 

1 

A 1 





1 20 1 

22 1 

23 1 
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6.5.2 Keyboard Map By Logical Key Name 

The following maps are provided to relate the description of the 
keyboard operations described in this specification to the actual 
codes generated at the coding interface. These maps identify 
those keys which have explicit names as legends on the key caps or 
Permanent Label Strip, and leave the alpha-numeric keys blank. 

The blank keys on the main array all have multiple mappings 
depending on the Keyboard Dialect and Keyboard Usage Mode. The 
names provided in this specification are the English equivalents, 
but on the various national keyboards they are translated into 
different forms. See DEC STD 107-2 when revised. 

On all Permanent Label Strips, the legends above the G15 and G16 
keys are replaced with the legends for the four LEDs that are 
physically located there or are blank for those product classes 
that do not actuate the LED. The LED legends are Hold Screen, 
Lock, Compose, and Wait. On all product classes of the keyboard, 
the Local Function keys and the Application Function Keys are 
blank, except for the G15 and G16 keys. The following keys have 
legends that depend on the keyboard product class: G15, G16, E16, 
E17, E18, D16, D17, D18, all numeric keypad keys. 
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Left Half - Keyboard Named Key Map 


|Hld|PrnlSetlF4 |Br-| | F6 | F7 | F8 | F9 1F10| | Fll | F12 | Fl3 | F14 j 
I Scr I Scr i-Up| j eak j 111111 j ESC j BS | LF j j 


Local Function Keys 


. . . . Application Function Key Row 



I I I I 


I I 


I I 


1<— I 
I Delet j 


Tab I 


I Ret 


I Ct- 1 Lock] 
I rl| I 


I Shift I 


I I 
I I 


I Compose I <space bar> 

jcharactj 


Shift I 


Main Key Array 


Right Half - Keyboard Named Key Map 


Editing 

Keypad 


Cursor 

Keypad 


1 F 1 

1 15| 

F 

16 

1 

1 

1 F 1 F 1 F 1 F 1 

1 17| 18| 19| 20| 

. . Application 

Function Key Row (cont.) .... 

1 Ell 

1 1 

E2 1 

i 

E3 1 

1 

1 PF |PF2 1 PF3 1 PF4 | 

1 1 1 1 1 

1 E4| 

1 1 

E5 1 

1 

E6| 

1 

1 7 1 8 1 9 1 - 1 

1 1 1 1 1 

1 

1 

1 


1 4 1 5 1 6 1 , 1 

1 1 1 1 1 

l<- 1 

1 1 

V 1 

1 

-> 1 

1 

1 1 1 2 1 3 1 E 1 

1 1 1 1^1 
- - — 1 T 1 


E 

R 


Numeric 

Keypad 
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6. 5.2.1 Application Function Key Labels - 

The Application Function Keys do not have any legends on them for 
any of the keyboard product classes, except for the two keys that 
have no corresponding room on the label strip for legends because 
of the LED legends. 

Application Function Key Legends 


DEC 

Key Id Standard 


DECmate/WPS 


G15 Help Help 

G16 Do Do 


6. 5. 2. 2 Editing Keypad Labels - 

The Editing Keypads for the product classes have the following 
keycap legends: 

Editing Keypad Legends 



DEC 


Key Id 

Standard 

DECmate/WPS 

E16 

Find 

Find 

E17 

Insert Here 

Insert Here 

E18 

Remove 

Remove 

D16 

Select 

Select 

D17 

Prev Screen 

Prev Screen 

D18 

Next Screen 

Next Screen 


Editing Keypad Front Legends 


(Used for Local Editing Extension on VT330/VT340) 


Key Id 

LK201- {NA 

E16 

Home 


Cursor 

E17 

Insert/ 


Overstrike 

E18 

CLR PAGE 


Clr Field 

D16 

( EDIT) 

D17 

Prev 


Page 

D18 

Next 


Page 
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6. 5. 2. 3 Cursor Keypad Legends - 

The legends for the Cursor Keypad as shown below: 

Cursor Keypad Legends 


Key Id 

Legend 

C17 

<upward arrow> 

B16 

<left arrow> 

B17 

<down arrow> 

B18 

<right arrow> 


6. 5. 2. 4 Numeric Keypad Legends - 

The legends for the Numeric Keypad are shown below: 

Numeric Keypad Legends 



DEC 


Key Id 

Standard 

DECmate/W 

E20 

PFl 

<gold> 

E21 

PF2 

Page 

E22 

PF3 

Del Word 

E23 

PF4 

Del Char 

D20 

7 

Sent 

D21 

8 

Tab Pos 

D22 

9 

Underline 

D23 

- (minus) 

Cut 

C20 

4 

Word 

C21 

5 

Para 

C22 

6 

Bold 

C23 

, ( comma ) 

Paste 

B20 

1 

Back Up 

B21 

2 

Line 

B22 

3 

Upper Case 

A20 

0 

Advance 

A22 

. (period) 

Sel 

A23 

Enter 

Enter <> 
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Numeric Keypad Front Legends 


Key Id 

LK201- {NA, PA} 

E20 

TAB |< 


>1 

E21 

Insert 


Line 

E22 

Delete 


Line 

E23 

Delete 


Char 

C23 

(Space) * 

A23 

Transmit 


* The VT330/VT340 provides a Set-Up option which allows C23 to 
transmit COMMA or SPACE (not mandatory). This is not a local 
editing feature. 
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6. 5. 2. 5 Permanent Label Strips - 

The following table describes the legends on the permanent label 
strips : 


Permanent Label Strips 



DEC 


Key Id 

Standard 

DECmate/WPS 

G99 

FI 

Hold Screen 

GOO 

F2 

Print Screen 

GOl 

F3 

Set-Up 

G02 

F4 

F4 

G03 

F5 

Break 

GOB 

F6 

F6 

G06 

F7 

F7 

GOT 

F8 

F8 

G08 

F9 

F9 

G09 

FlO 

FlO 

Gil 

Fll 

Fll (ESC) 

G12 

F12 

F12 (BS) 

G13 

F13 

F13 (LF) 

G14 

F14 

F14 

LED: 

Hold Screen 

Hold Screen 

LED: 

Lock 

Lock 

LED: 

Compose 

Compose 

LED: 

wait 

Wait 

G20 

F17 

F17 

G21 

F18 

F18 

G22 

F19 

F19 

G23 

F20 

Hyph Push 
Hyph Pull 
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6.5.3 Recommended Labeling For System Label Strips 

The following labeling is recommended as a guideline to product 
implementors in designing System Label Strips, but is not required 
for conformance: 


Key 




Id 

Legend 



G99 

Hold Screen 

(or Hold 

Session) 

GOO 

Print Screen 

(or Local Print) 

GOl 

Set-Up 



G02 

f4 



G03 

Break 



G05 

Interrupt 



G06 

Resume 



G07 

Cancel 



G08 

Main Screen 



G09 

Exit 



Gll 

Fll (ESC) 



G12 

F12 (BS) 



G13 

F13 (LF) 



G14 

Additional Options 


LED: 

Hold Screen 

(or Hold 

Session ) 

LED: 

Lock 



LED: 

Compose 



LED: 

Wait 



G20 

F17 



G21 

F18 



G22 

F19 



G23 

F20 




Notes 


1. GOO is labelled "Local Print" on the VT330/VT340 since 
these terminals can support two sessions with windows on 
the screen at one time. Local Print in this case may 
print the logical display (virtual screen) for one 
session which is not the same as the physical screen. 

2. G02 (F4) is labelled "Switch Session" on the VT330/VT340. 

3. G02 (f 4) is labelled "Data/Talk" on the VT200 series for 
use with an integral modem option. 


BDBDQSD 


TM 
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6.6 KEYBOARD OPERATION AND STATE THAT AFFECTS USER INTERACTION 

This section describes those functions and state that pertain to 
all keyboard areas and affect user interaction with the keyboard 
(but not keyboard encoding). Subsequent sections describe 
functions and state that pertain to particular keyboard areas or 
modify the codes transmitted by keystrokes. 

The keyboard is sensitive to the following operating modes that 
affect user interaction: 

Keyboard Action Mode (KAM): locked or unlocked. When 
locked, all but the local function keys F1-F5 are 
disabled. 

- Preference modes of Auto Repeat, Keyclick, Margin Bell, 
and Warning Bell. Choices are Enable, or Disable. 


6.6.1 Keyboard Output Silo 

The terminal shall maintain a silo for keyboard output. In the 
event that the keyboard produces characters faster than they can 
be transmitted by the terminal, the silo shall buffer at least 9 
keystrokes. Note that function keys may produce up to five bytes 
per keystroke > while alpha-numeric input will produce only one 
byte. For the purpose of buffering, a compose sequence will be 
treated as a single keystroke and shall use only one silo 
position. Therefore function keys, composed sequences, and 
alpha-numeric input will each take one silo position per 
occurrence. (Guideline: the VT320 provides a 25 keystroke silo.) 


TM 
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6.6.2 Keyboard Action Mode 

The keyboard shall lock when one of the following conditions 
occur: 


o The keyboard output silo is full. 

o Keyboard Action Mode (KAM) is placed in the set state by 
execution of a SH (SET MODE) control sequence. 


I When the keyboard is locked, the Wait indicator is turned on, and 
I all keyboard keys except Fl, F2, F3, F4 and F5, that is, the local 
I function keys, are disabled. F5, break, may be disabled by other 
I means and is unaffected by setting or resetting KAM. Entering 
Set-Up unlocks the keyboard for the time the terminal is in 
Set-Up, then upon exiting Set-Up the keyboard is locked again, 
unless the terminal user had explicitly executed a control 
function that unlocks the keyboard. 

The keyboard will unlock when one of the following conditions 
occur and the keyboard output silo is not full: 

1. The keyboard output silo has been partially emptied 
(while KAM is in the reset (unlocked) state). 

2. Keyboard Action Mode (KAM) is placed in the reset state 
by execution of a RM (RESET MODE) control sequence. 

3. The SELECT CONFORMANCE LEVEL (DECSCL) control sequence is 
executed (any level selected by the parameter). 

4. The RESET TO INITIAL STATE (RIS) control function is 
executed. 

5. The power up self-test is executed. 

I 6. Entering Set-Up in Level 1. 

I 7. Executing Clear Comm or Reset Terminal in Set-Up. 

I 8. The SOFT TERMINAL RESET (DECSTR) control sequence is 

executed. 


KID' 
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SET/RESET KEYBOARD ACTION MODE KAM 


Levels: 1, 2 

Purpose: Lock or unlock the entire keyboard. 


Set Format: 

CSI 

2 

h 


9/11 

3/2 

6/8 

Reset Format: 

CSI 

2 

1 


9/11 

3/2 

6/12 


Description: The KAM control is used to set or reset the state 

of Keyboard Action Mode. When Keyboard Action Mode is reset 
(Unlocked), all keys on the keyboard transmit their defined codes 
or codes sequences. When Keyboard Action Mode is set (locked), 
the entire keyboard shall not transmit any codes and shall not 
keyclick, if enabled, until the state is reset. 


State Affected: 

KEYBOARD ACTION MODE: ( UNLOCKED , LOCKED); 


Algorithm: 

PROCEDURE SET_KEYBOARD_ACTION_MODE ; 
BEGIN 

KEYBOARD_ACTION_MODE:= LOCKED; 

END ; 


PROCEDURE RESET_KEYBOARD_ACTION_MODE ; 
BEGIN 

KEYBOARD_ACTION_MODE : - UNLOCKED ; 

END; 


Known Deviations; 

This control is ignored by the VTlOO and VT125. 
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6.6.3 Auto Repeat Mode 

The terminal shall provide the ability to select whether the 
keyboard keys will automatically transmit codes at a periodic rate 
when held down [set state] or will transmit only one code each 
time they are depressed [reset state]. 

Auto-repeat can be disabled or set to a variable rate as a Set-Up 
feature. (Note; Provision of variable auto-repeat rates is an 
option, and is not required for conformance.) One of the rates 
provided shall be 30 keystrokes per second, continuous. Keys 
which can auto-repeat will start auto-repeating within H second of 
the time the initial key depression occurs. If the control 
sequence to turn auto-repeat off (DECARM) is received while an 
auto-repeat is in progress, the key will stop auto-repeating. If 
the control sequence to turn auto-repeat on is received when a key 
which had previously been auto-repeating is still held down, the 
key will immediately auto-repeat without delay. Except for the 
above, the effect of auto-repeating a key shall be the same as 
I pushing the key a number of times. While any key is auto 
I repeating, the affect of shift or control apply immediately. No 

I new "start-up delay" results. 


Note 

The interval between the time the DECARM control 
is received and the time a key which was already 
auto-repeating actually stops repeating is 
UNDEFINED, and should not be depended upon by 
conforming software. For the purpose of testing 
compliance with the architecture, auto-repeat must 
stop within five seconds of receiving the DECARM 
control when the terminal is processing host 
output (not blocked by hold screen or alternate 
session) . 


mmr 
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SET/RESET AUTO REPEAT MODE DECARM 


Levels; 1, 2 

Purpose: Turn auto-repeating of keys on and off. 


Set Format: 

CSI 

? 

8 

h 


9/11 

3/15 

3/8 

6/8 

Reset Format: 

CSI 

? 

8 

1 


9/11 

3/15 

3/8 

6/12 


Description: The DECARM control is used to set or reset the 

state of Auto Repeat Mode. When Auto Repeat Mode is reset 
( Repeat_Of f ) , none of the keyboard keys will auto repeat as a 
result of being held down. When Auto Repeat Mode is set 
(Repeat_On) certain keys will repeat at a fixed rate as a result 
of being held down (see description above). 


NOTE 

Auto Repeat Mode is a User Preference Feature and 
should only be used by conforming software in 
response to explicit requests of the terminal 
user . 


State Affected: 

AUTO REPEAT MODE: (REPEAT OFF, REPEAT ON) ; 


Algorithm: 

PROCEDURE SET_AUTO_REPEAT_MODE; 
BEGIN 

AUTO_REPEAT_MODE ; - REPEAT_ON ; 
END; 


PROCEDURE RESET_AUTO_REPEAT_MODE ; 
BEGIN 

AUTO_REPEAT_MODE ; - REPEAT_OFF ; 
END; 


Known Deviations; None 
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6 .6. 3.1 Keys Which Do Not Auto Repeat - 

All keys that transmit bytes across the coding interface shall be 
auto-repeatable, with the exception of the Return and Escape key. 
Only keys that do not transmit immediately shall not auto-repeat. 
The keys that do not auto-repeat are: 

1. Return Key 

2. Escape Key 

3. The Local Function Keys 

4. Control key by itself (control characters auto-repeat) 

5. Shift key by itself (shifted characters auto-repeat) 

6. Lock 

7 . Compose 

8. Non-Spacing Diacritical keys 

9. Keys in an explicit or implied compose sequence 


TM 
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6. 6. 3. 2 Auto Repeat Guidelines - 

In order to give a constant repeat rate at each transmission 
speed, the speed of auto repeat is a function of the Host Transmit 
Speed. At speeds of 2400 Baud or above, all keys will auto repeat 
at 30 keystrokes per second. 

The following table is provided as a guideline and is not required 
for conformance. 

For the purpose of auto repeat, the keyboard is separated into 
three groups: 

1. Group A - Main typing array 

2. Group B - Cursor keys and numeric keypad keys 

3. Group C - Top row function keys and editing keys 

Every key in each group will auto repeat at the fixed rate set by 
the transmit speed, regardless of how many codes the key actually 
transmits . 


Host Port 
transmit Speed 


Auto Repeat Rates 


Group A 


Group B 


Group C 


2400 Baud or above 30 
1200 30 

600 30 

300 30 

150 13 

110 10 

75 6 


keys/sec 30 keys/sec 

30 
20 
10 
6 
6 
6 


30 keys/sec 
24 
12 
6 
6 
6 
6 


These repeat rates assume that an 8-bit character is used, either 
8-bit data with no parity, or 7-bit data plus a parity bit. Also 
for speeds of 300 baud or above 1 stop bit is assumed, for 150 
baud or below, 2 stop bits are assumed. Other settings of these 
parameters will not change the repeat rate, however selecting 
8-bits plus parity and/or 2 stop bits will, in some cases, cause a 
slight irregularity in the repeat rate as the keyboard transmit 
silo fills up. The "Limited Transmit" feature will not affect 
auto repeat rates, since all five codes can be transmitted at the 
limited speed of 150 characters per second. In local mode, keys 
will auto repeat at 30 keystrokes per second. 


mao' 
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6.6.4 Visual Indicators 

6. 6. 4.1 Hold Screen Indicator - 

The Hold Screen LED will be lit whenever the screen image (or 
display of one or more sessions) is being held. It will be off 
whenever the screen is not being held. When the HOLD SCREEN (HOLD 
SESSION) key is pressed the LED shall toggle along with the 
function. 


6. 6. 4. 2 Lock Key Indicator - 

The LOCK LED lights whenever the Shift Lock mode or Caps Lock mode 
is in effect. The LED will toggle along with the corresponding 
mode . 

If a Shift Lock keyboard is selected in Set-Up, Shift Lock mode is 
turned on by pressing the LOCK key, and turned off by pressing 
either the LOCK key or a SHIFT key. If a Caps Lock keyboard is 
selected in Set-Up: Caps Lock mode is toggled on or off by 
pressing the LOCK key. 


6. 6. 4. 3 Compose Indicator - 

The COMPOSE LED is turned on at the start of a compose. A compose 
is initiated either by typing the Compose Key or by typing a 
non-spacing diacritical mark. It remains on until one of the 
following occurs: 

1. The character has been composed. 

2. An error occurs. 

3. The delete key is pressed. 


Errors during compose terminate the compose and turn off the LED. 


6. 6. 4. 4 Keyboard Lock (Wait) Indicator - 

The Wait LED lights when* the keyboard is locked either because of 
data overrun (XOFF synchronization control code received from the 
host) or because of receipt of the control sequence which locks 
the keyboard (KAM). The LED is off whenever the keyboard is not 
locked. If the keyboard is locked during a compose, the compose 
is suspended until the keyboard is unlocked or until an action, 
such as enter Set-Up, is taken. 
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6.6.5 Audible Indicators 
6. 6. 5.1 Warning Bell - 

The Warning Bell will be sounded (if it is enabled in Set-Up) 
whenever one of the following occur; 

a. A CTRL-G (BEL) is received by the terminal - ring when 
the character would have gone to the screen had it been 
printable . 

b. When a compose error is made. 

c. When the margin is reached (subject to Set-Up). 

Closely spaced bell codes will be sounded individually at a rate 
of 4-5 per second. As bell characters arrive, they are stored in 
a bell buffer until they can be sounded. The bell buffer will 
have 10 entries. If the bell buffer fills, additional bell 
characters will be discarded until there is space in the bell 
buffer . 

No control function is provided to enable/disable the Warning Bell 
from the host. It may be possible to change the volume of the 
Warning Bell, or disable it entirely, as a local Set-Up function 
(not mandatory). 


6. 6. 5. 2 Margin Bell - 

The Margin Bell is set to RING ENABLED when the all of the 
following conditions are true; 

1. Margin Bell is enabled in Set-Up ("Margin Bell"). 

2. A "normal keystroke" is typed (while not in SET-UP mode). 

NOTE 

In this context, a normal keystroke is any 
keystroke which does not generate one of the 
following characters as the first character; 

ESC, CSI, DCS. A COMPOSE is a "normal keystroke" 
(even though it is 2 or 3 keystrokes) since it 
results in one displayable character. Examples 
of normal keystrokes are "A", "=■" and "COMPOSE e 
'" (<e'>), and (usually) the UDKs (i.e. 

Shift-F6) . 
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The Margin Bell is rung under the following conditions: 

a. The MARGIN BELL is RING ENABLED. 

b. Any character is printed to the screen which causes the 
cursor to move from a column »< (RIGHT MARGIN - 8) to any 
column on the same line > (RIGHT MARGIN - 8). Note 
horizontal positioning controls do not ring the bell or 
affect whether the bell is ring enabled (these characters 
are not "printed" to the screen). 

The Margin Bell is set to RING DISABLED when: 

1. Margin Bell is disabled in Set-Up ("No Margin Bell"). 

2. The Margin Bell has been rung. 

3. The cursor moves to a new line. 

4. The terminal is in Set-Up 

The MARGIN BELL conditions described above are dynamic. Because 
of this the following might occur: 

With the cursor at column RIGHT MARGIN - 8 an 'A' (or any normal 
Jceystroke) is typed, thus setting the MARGIN BELL to RING ENABLED 
(assuming that Margin Bell is enabled in Set-Up). 

A linefeed is now sent to the screen which will leave the cursor 
in column RIGHT MARGIN - 8 but on the next line. This will cause 
the the Margin Bell to be set to RING DISABLED. 

The 'A' is now sent to the screen causing the cursor to move from 
RIGHT MARGIN - 8 to RIGHT MARGIN - 7, but the MARGIN BELL does not 
ring because it is RING DISABLED. 

Had the 'A' been sent to the screen before the linefeed, the 
MARGIN BELL would have rung. It depends on the status of RING 
ENABLED/DISABLED at the instant the other condition for ringing 
the Margin Bell is satisfied. 

No control function is provided to enable/disable the Margin Bell 
from the host. It may be possible to change the volume of the 
Margin Bell, or disable it entirely, as a local Set-Up function 
(not mandatory). 


6. 6. 5. 3 Keyclick - 


Keyclick may be enabled or disabled in Set-Up. If Keyclick is 
enabled, the keyboard will "click" once for each depression of a 
key. If a key is auto-repeating, the click will occur once for 
each key sent, (that is, once for each alphabetic character and 
once for each control sequence from a function key) . The keyclick 
shall be synchronized with the actual keystroke or auto-repeat 
rate. All keys which transmit codes or cause the terminal to take 
some immediate action click. 


mi 
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Set-Up, Hold Screen, Lock, and Compose all click since they invoke 
I immediate actions (Lock and Compose change the input mode). The 

I Shift key will click if exiting the Shift Lock state, otherwise it 

I does not click. The Shift (except for the above noted exception) 

I and the Control keys do not click since these keys do not cause 

any immediate action by themselves, but are intended to be pressed 

in conjunction with another key. Keys that form invalid control 
combinations do not click. Keys which are inoperative due to 
Level 1 operation or because the Host Port Environment Mode is 
7-bits also do not click. 

I No control function is provided to affect the state of keyclick 
I from the host. It may be possible to change the volume of the 
I keyclick sound, or disable it entirely, as a local Set-Up function 
I (not mandatory). 


6. 6. 5. 3.1 Interaction Of Keyclick And Bells - If a keyclick and a 
bell are generated by the same action, for example typing the 
second character in some invalid compose sequences, then either 
bell (Warning or Margin) takes precedence over the keyclick, and 
the keyclick is not generated. 


miiDiim’' 
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6.7 KEYBOARD STATE AND OPERATING MODES THAT AFFECT KEYBOARD 
ENCODING 

The keyboard is sensitive to the following operating modes that 
affect what codes are transmitted: 

- Emulation mode: Primarily affects codes transmitted by 
function keys: One of VT52, VTlOO or VT300. 

- Cl Transmission mode: Affects how Cl controls are 
transmitted. One of "7-bit controls", or "8-bit 
controls". 

- Character Set Mode: Primarily affects keyboard encoding. 
Choices are "7-bit Characters", or "8-bit Characters". 

- User Preference Supplemental Set (UPSS): Determines 
keyboard supplemental set when 8-bit characters are 
enabled. Also establishes initial supplemental set for 
display (defaults to G2 on power-up), and allows one 
level of software indirection for designating 
supplemental character sets. Choices are "DEC 
Supplemental" or "ISO Latin-1". 

- Keyboard Dialect: Primarily affects keyboard layout by 
specifying which country keyboard to use. When 7-bit 
Characters and Typewriter mode are in effect, the 
Keyboard Dialect also selects the corresponding National 
Replacement Character Set. 

- Keyboard Usage Mode: Primarily affects keyboard layout. 
In 7-bit Characters mode, also affects character 
encoding. Choices are "Data Processing Keys" or 

" Typewr i ter Key s " . 

Host line environment: Establishes frame size for 
character transmission. May restrict terminal to 7-bit 
characters. Choices are "7-bit host line", or "8-bit 
host line". 

- Lock key mode: One of Caps Lock or Shift Lock. 

- BackArrow key mode: One of Delete or Backspace (not 
mandatory) . 

- Set-Up feature to disable break. Choices are Break, or 
No Break. Disables generating break signal when Break 
Key alone is pressed. Does not affect Shift-Break, or 
Control-Break . 

Set-Up feature to disable Compose key (not mandatory). 
Does not disable auto-compose sequences which do not use 
the Compose key. 

- Set-Up feature to remap shifted comma and period to send 
< and > (not mandatory) . 
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Set-Up feature to remap <> key to send (not 
mandatory) . 

- Set-Up feature to remap key to send ESC (not 
mandatory) . 

- Set-Up feature to remap KP, (keypad comma) to send SPACE 
(not mandatory). 

Cursor Key Mode: selects between having the four cursor 
(arrow) keys transmit ANSI standard cursor movement 
escape sequences, or Application Function Codes. See 
"Cursor Keys" section below. 

- Numeric Keypad Mode: selects between having the 
auxiliary keypad keys transmit ASCII decimal digits (3/0 
to 3/9) 'Numeric' mode, or application control functions 
'Application Mode'. See "Numeric Keypad Keys" section 
below. 


6.7.1 VT52 And VTlOO (Level 1) Emulation Mode 

In VT52 and VTlOO Emulation modes, the following restrictions 
apply to the keyboard. Keys which are dead are completely ignored 
by the terminal. They do not click, transmit any code, or cause 
the terminal to perform any action. The keys are referred to by 
their names. See the "Named Key Map". 

a. Only 7-bit character codes may be produced. This 
restricts DEC Multinational and ISO Latin-1 to their 

7- bit ASCII subset. 

b. The six "Edit Keys" El, E2 , E3, E4 , E5, and E6 are dead. 

c. Function Keys F6, F7 , F8 , F9 , and FlO are dead. 

d. Function Key Fll will transmit ESC. This key will not 

auto-repeat. 

e. Function Key Fl2 will transmit BS 

f. Function Key F13 will transmit LF 

g. Function Keys F14, F15, F16, F17, F18, F19, and F20 are 
dead. 

h. There will be no eight bit characters generated. Keys 
which would normally produce an 8-bit code will be dead 
(exception is British pound sign which transmits 10/3 in 

8- bits, and shall transmit 2/3 for VTlOO compatibility). 

i. Compose will work only to produce 7-bit codes. Any 
attempt to compose an 8-bit code will result in the 
compose error recovery. 

j. Eight bit control characters (Cl characters) cannot be 
generated . 


mmr 
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6.7.2 VT200 (Level 2) And VT300 (Level 3) Emulation Mode 

All function keys are live. The Function Keys, including Fll, 

Fl2, and Fl3 all transmit control sequences. ESC, BS, and LF are 
not available on Fll, Fl2, and F13. BS may be available if 
Backspace mode of Backarrow key is selected. If the host line 
environment is 8-bits, the full repertoire of currently selected 
character encodings is available. If the host line environment is 
7-bits, there are restrictions: 

a. Functions keys and other 8-bit controls are sent using 
ESC Fe sequences instead of CSI sequences, regardless of 
the Cl Transmission Mode. 

b. Only the 7-bit ASCII subset of DEC Multinational or ISO 

, Latin-1 may be generated. Keystrokes that would produce 
8-bit codes are dead. Compose only works when used to 
produce 7-bit codes. 

Local mode operation is never subject to the restrictions of the 
7-bit host line environment. 


6.7.3 Cl Transmission Mode 

This mode selects how Cl controls are transmitted in Level 2 or 
Level 3. "7-bit Controls" forces all function keys and other Cl 
controls to be sent in their 7-bit format as ESC Fe sequences. 
"8-bit Controls" causes Cl controls to be sent in their 8-bit 
format (from columns 8 and 9 in the code table) when operating in 
Level 2 or Level 3, 8-bit Characters. If the host line 
environment is 7-bits, Cl controls are restricted to their 7-bit 
format regardless of the Cl Transmission mode. 

The following control functions can also be used to set the Cl 
Transmission mode. 


S7C1T - Select 7-bit Cl Transmission 
ESC 2/0 4/6 (ESC SP F) 

S8C1T - Select 8-bit Cl Transmission 
ESC 2/0 4/7 (ESC SP G) 
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6.7.4 Character Set Mode 

The Character Set Mode selects between "8-bit Characters" or 
"7-bit Characters" for keyboard character encoding. 

When 8-bit Characters is selected, the keyboard will transmit 
8-bit graphic characters as ASCII from GL and either DEC 
Supplemental or ISO Latin-1 supplemental from GR. The use of DEC 
Supplemental or ISO Latin-1 supplemental is determined by the User 
Preference Supplemental Set (UPSS). Note: If the host line 
environment is set to 7-bits, the keyboard is restricted to 7-bit 
Characters . 

When 7-bit Characters is selected, the keyboard shall only 
generate 7-bit characters. All attempts to generate 8-bit codes 
when in 7-bits (such as COMPOSE sequences) will fail. The 
keyboard character set is determined by the Keyboard Usage Mode 
(Typewriter or Data Processing), and Keyboard Dialect. See below. 

Explanatory Note 

The character set mode, 7-bit/8-bit Characters 
corresponds to National/Multinational Mode on the 
VT200 but with two simplifications. 8-bit 
Characters are temporarily disabled when in "VTlOO 
mode", or a "7-bit host line" is selected. In 
practice, this means the terminal no longer 
supports ASCII with the Typewriter Keys layout 
except on the North American Keyboard. This makes 
sense. The typewriter layout has no inherent 
advantage when using ASCII, it simply has more 
dead keys. Confusing distinctions like VTlOO 
Multinational mode have been eliminated. 


emr 
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SET/RESET CHARACTER SET MODE DECNRCM 

Levels: 2x, 3x 

Purpose: Select 7-bit or 8-bit Characters for keyboard encoding 


Set Format: 

CSI 

9/11 

? 

3/15 

4 

3/4 

2 

3/2 

h 

6/8 

(7-bit Characters) 
( National ) 

Reset Format: 

CSI 

9/11 

? 

3/15 

4 

3/4 

2 

3/2 

1 

6/12 

(8-bit Characters) 
(Multinational ) 


Description: The DECNRCM control is used to select between 7-bit 

or 8-bit Character sets for keyboard encoding. Note: Setting 
this mode has the side effect of resetting the display character 
sets to their default state, i.e. the state at power-on or reset. 


State Affected: 

CHARACTER_SET_M0DE : (EIGHT_BITS, SEVEN_BITS ) ; 

R_CHARACTER_SET_MODE : ( EIGHT_BITS , SEVEN_BITS ) ; 

(* used to keep track of character set mode 

when a restrictive condition (7-bit Host Line, 
or VTlOO mode) is in effect. *) 

IN_USE_TABLE 
DESIGNATED GRAPHIC SETS 


Algorithm: 

PROCEDURE SET_CHARACTER_SET_MODE; 

BEGIN 

CHARACTER_SET_MODE:= SEVEN_BITS; 

(* keep track of mode if there are restrictions in effect *) 
R_CHARACTER_SET_MODE : - SEVEN_BITS ; 

IF KEyBOARD_USAGE_MODE - TYPEWRITER THEN 
BEGIN 

IN_USE_TABLE.GL:» NRCS_LIST( KEYBOARD_DIALECT ) ; 
IN_USE_TABLE.GR:= NRCS_LIST[ KEYBOARD_DIALECT ] ; ; 
DESIGNATED_GRAPHIC_SETS[GO ] := NRCS_LIST[ KEYBOARD_DIALECT ] ; 
DESIGNATED_GRAPHIC_SETS[G1] :- NRCS_LIST[ KEYBOARD_DIALECT] ; 
DESIGNATED_GRAPHIC_SETS[G2] NRCS_LIST[ KEYBOARD_DIALECT] ; 
DESIGNATED_GRAPHIC_SETS(G3] := NRCS_LIST[ KEYBOARD_DIALECT ] ; 
END ; 

ELSE 

(* keyboard usage mode is Data Processing *) 

BEGIN 

IN_USE_TABLE.GL:= ASCII_G; 

IN_USE_TABLE.GR:= ASCII_G: 

DESIGNATED_GRAPHIC_SETS[GO] := ASCII_G; 
DESIGNATED_GRAPHIC_SETS[G1] := ASCII_G; 

DESIGNATED GRAPHIC SETS(G2]:= ASCII G; 
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DESIGNATED_GRAPHIC_SETS[G3 ] := ASCII_G; 
END; 

END; 


PROCEDURE RESET_CHARACTER_SET_MODE ; 

BEGIN 

CASE CONFORMANCE_LEVEL OF 

(* keep track of mode if there are restrictions in effect *) 
R_CHARACTER_SET_MODE : - EIGHT_BITS ; 

(* ignore if 7-bit host line or VTlOO mode *) 

IF (ENVIRONMENT_TYPE <> SEVEN_BITS) AND 
( CONFORMANCE_LEVEL <> LEVEL_1 ) THEN 
BEGIN 

CHARACTER_SET_MODE:= EIGHT_BITS; 

IN_USE_TABLE.GL:= ASCII_G; 

IN_USE_TABLE.GR:= UPSS_G; 

DESIGNATED_GRAPHIC_SETStGO] ASCII_G; 
DESIGNATED_GRAPHIC_SETS(G1] ASCII_G; 
DESIGNATED_GRAPHIC_SETS(G2 ] :- UPSS_G; 
DESIGNATED_GRAPHIC_SETS[G3 ] UPSS_G; 

END; 

END; 


Known Deviations; None 
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6.7.5 Keyboard Usage Mode 

Each version of the keyboard is oriented toward a particular 
language and/or country. The North American version, for example, 
has all 94 characters of ASCII on separate keys. Therefore, 
compose sequences are not needed to transmit ASCII characters, 
only to transmit Supplemental characters. Many of the keyboards 
have one or more keys which generate different characters 
depending on whether the keyboard is set to Data Processing mode 
or Typewriter mode (for data processing versus office use). The 
data processing legends appear to the right of the typewriter 
legends, if different. When in Data Processing mode, these keys 
generate the character codes for the data processing legends. 

When in Typewriter mode, these keys generate character codes for 
their typewriter legends. 

When the terminal is in 7-bit Characters Mode, selecting Data 
Processing Keys also selects the ASCII character set instead of 
the National Replacement Character Set (NRCS) corresponding to the 
Keyboard Dialect, as would be the case if Typewriter keys were 
selected. 

The keyboard usage mode is selectable from Set-Up, or by host 
control function (DECKBUM) in Level 3. 

The tables later in this section list all the keys and characters 
produced for each mode. The following list summarizes the Data 
Processing characters by key position for each country keyboard. 
The most recent or recommended variation for each dialect is 
listed first. Note this list applies to the Keyboard Dialect 
(keyboard mapping tables) chosen in Set-Up, not the physical 
Iceyboards . 


1. North American - none 

2. British (LK201-EE US/UK) 
EOS has "#" 

3. British (LK201-AE) 

EOS has "#" 

Dll has "\" 

4. Flemish (Belgium) 

E06 has "[" 

E07 has "]" 

Cll has "\" 

5. Canadian (French) 

Dll has "]" and 
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6. 

Danish 

(2nd 

, LK201-ED) 



EOO 

has 






E03 

has 






Dll 

has 

11 1 11 

and 

11 j 11 



CIO 

has 

11 j 11 

and 

11 J 11 



Cll 

has 

11 1 11 

and 

11\^11 


7. 

Danish 

( 1st 

, LK2 01-AD) 



E03 

has 






Dll 

has 

11 J 11 

and 

11 ^ 11 



Cll 

has 


and 

IlN^II 


8. 

Finnish 

(3rd, LK201-NX) 



E03 

has 






Dll 

has 

11 1 11 

and 

11 j 11 



D12 

has 


and 

11 ^ 11 



CIO 

has 

11 1 11 

and 

11\^11 



Cll 

has 

11 j 11 

and 

11 ^ 11 


9. 

Finnish 

(2nd, LK201-NF) 



E03 

has 






Dll 

has 

11 J 11 

and 

11 ^ 11 



D12 

has 

11 #11 

and 

11\^11 


10. 

Finnish 

(1st, LK201-AF) 



E03 

has 






Dll 

has 

11 j 11 

and 

11 J 11 



D12 

has 

11 #11 

and 

11\^11 


11. 

Austrian/Ge 

rman 

(2nd, LK201- 

-NG) 


Ell 

has 

11 1 11 





Dll 

has 

11011 

and 

ii\^ii 



CIO 

has 

11 j 11 

and 

11 ^ 11 



Cll 

has 

11 J 11 

and 

11 ^ 11 


12. 

Austrian/Ge 

rman 

(1st, LK201- 

-AG) 


Dll 

has 

110.. 

and 

ii\^ii 



Cll 

has 

11 j 11 

and 

11 ^ 11 



13. Dutch (2nd, LK201-NH equivalent to LK201-EE) 

14. Dutch (1st, LK201-AH) 

E02 has "(" 

E03 has "]" 

ElO has "\" 

15. Italian 
EOl has 
E02 has "#" 

E09 has 
ElO has "]" 

C12 has "\" 
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16. 


18. 


19. 


20 . 


Swiss (French) 

E04 

has 


Dll 

has 


CIO 

has 

tt ^ tf 

Cll 

has 

tt J ft 

C12 

has 



Swiss (German) 


E04 

has 

110 N 



Dll 

has 




CIO 

has 

tt 1* If 



Cll 

has 

It J tl 



C12 

has 




Swedish 

(2nd, LK201-NM 

EOS 

has 




Dll 

has 

It j tt 

and 

tl 1* tt 

D12 

has 


and 

tt\^tt 

CIO 

has 

It J tf 

and 

tt 1 tt 

Cll 

has 

ft 1 If 


Swedish 

(Is 

t, LK201-AM 

EOS 

has 

It0ff 



Dll 

has 

ft J It 

and 

ft ^ tl 

D12 

has 

ft#tf 

and 

tf V^tt 

Norwegian ( 

2nd , 

LK201-] 

Dll 

has 

tt 1 tt 

and 

tt j tt 

CIO 

has 

tt 1 tt 

and 

ttv^tt 

Cll 

has 

ft j tt 

and 

tt ^ tt 


21. Norwegian (1st, LK201-AN) 
EOS has 



Dll 

has 

ft J tt 

and 

tf ^ ft 


Cll 

has 


and 

ttv^tt 

22. 

Belgian/Frei 

nch 



E06 

has 

It ^ tt 




E07 

has 

• It j tf 




Cll 

has 

ft\^ff 



2S. 

Spanish 





EOO 

has 

11011 

and 

flv^tt 


E12 

has 

tl j If 

and 

tf ^ tf 

24. 

Portuguese 

- none 
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SET/RESET KEYBOARD USAGE MODE DECKBUM 


Levels; 2x, 3 

Purpose; Select Data Processing or Typewriter Keys mode. 


Set Format: 

CSI 

9/11 

? 

3/15 

6 

3/6 

8 

3/8 

h 

6/8 

(D.P. ) 

Reset Format; 

CSI 

9/11 

? 

3/15 

6 

3/6 

8 

3/8 

1 

6/12 

( Typewriter ) 


Description; The DECKBUM control is used to select between Data 
Processing or Typewriter Keys mode. 

Note; 


Keyboard Usage Mode is a User Preference Feature and 
should only be used by conforming software in response to 
explicit requests of the terminal user. 


State Affected; 

KEYBOARD_USAGE_MODE ; ( TYPEWRITER_KEYS , DATA_PROCESSING_KEYS ) ; 


Algorithm; 

PROCEDURE SET_KEYBOARD_USAGE_MODE ; 

BEGIN 

KEYBOARD_USAGE_MODE ; = DATA_PROCESSING_KEYS ; 
END; 


PROCEDURE RESET_KEYBOARD_USAGE_MODE ; 
BEGIN 

KEYBOARD_USAGE_MODE ; - TYPEWRI TER_KE YS ; 
END ; 


Known Deviations; None 
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6.7.6 Keyboard Dialect 

The Keyboard Dialect primarily effects the keyboard layout by 
specifying which country keyboard to use. When 7-bit Characters 
and Typewriter mode are in effect, the Keyboard Dialect also 
selects the corresponding National Replacement Character Set (new 
for Level 3 ) . 

When 7-bit Characters and Typewriter Keys mode are selected, the 
terminal generates characters from the current National 
Replacement Character Set (NRCS) determined by the Keyboard 
Dialect. This applies in all emulation modes: VT52, VTlOO (Level 
1), and VT200 (Level 2). NRCS are by definition 7-bit sets, thus 
only 7-bit codes will be generated. Additional compose sequences 
are available in this mode to generate characters that are in the 
current NRCS but not on the corresponding country keyboard. 

Guideline: On the VT320, the national replacement character set 

for each keyboard is as follows: 

1. North American - 7-bit Characters mode is not available. 
(ASCII is the left hand graphic set for both DEC 
Multinational and ISO Latin-1) 

2. Flemish - French NRCS/AFNOR NF Z 62-010 (1973] 

3. Canadian (French) - DEC French Canadian NRCS 

4. British - British NRCS/BS 4730 

5. Danish - Norwegian/Danish NRCS 3/NS 4551-1, DS 2089 

6. Finnish - DEC Finnish NRCS 

7. Austrian/German - German NRCS/DIN 66 003 

8. Dutch - 7-bit Characters mode is not available (same as 
North American). 

9. Italian - ISO Italian NRCS 

10. Swiss (French) - DEC Swiss NRCS 

11. Swiss (German) - DEC Swiss NRCS 

12. Swedish - DEC Swedish NRCS 

13. Norwegian - Norwegian/Danish NRCS 3/NS 4551-1, DS 2089 

14. Belgian/French - French NRCS/AFNOR NF Z 62-010 [1973] 

15. Spanish - ISO Spanish NRCS 

16. Portuguese - DEC Portuguese NRCS 


For more information on character sets and coding, refer to DEC 
STD 169 Digital Standard Coded Graphic Character Sets for Hardware 
and Software. 


6. 7. 6.1 British Pound Sign <L“> - 

The North American keyboard dialect differs from the British 
keyboard dialect only in the meaning of the Shift-3 (E03) key. A 
single keyboard model (LK201-EE) accomodates both of these 
keyboard dialects. 

When "North American Keyboard" is selected, the Shift-3 key always 
sends 2/3 ("#" from ASCII character set). 
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When "British Keyboard" is selected, the setting of Character Set 
Mode, 8-bit Characters/7-bi t Characters (DECNRCM) determines 
whether the British Pound Sign character is sent as 10/3 or 2/3. 
In the former case, from the DEC (or ISO) Supplemental character 
set, in the latter case from the UK national character set. When 
in 7-bit Characters mode, and the Keyboard Usage Mode is set to 
Data Processing Keys, the Shift-3 key sends 2/3 ("#" from ASCII 
character set ) . 

The possible combinations are summarized in the chart below: 


Keyboard 

DECNRCM 

Keyboard 

Code sent 

Character 

Dialect 

setting 

Usage Mode 

by terminal 

and 

set 

British 

8-bit Chars. 

either 

10/3 

£ - 

DEC or ISO 
Supplemental 

British 

7-bit Chars. 

Typewriter 

2/3 

£ - 

British NRC 

British 

7-bit Chars. 

Data Proc. 

2/3 

# - 

ASCII 

N. America 

N/A * 

either 

2/3 

# - 

ASCII 


* when "North American" dialect is selected, 
7-bit characters mode is not available. 

The legend for the shift 3 (E03) key is #£. 
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6 . 8 CURSOR KEYS 

The four cursor arrow keys are intended for use by the terminal 
user to indicate movement of the cursor symbol in the display. No 
I action to move the cursor is performed by the terminal unless it 
I is in Local Mode or Local Editing Mode. The cursor movement 

I controls must be transmitted to the terminal on receipt of these 
sequences in order for a corresponding movement of the cursor 
symbol to occur. 


6.8.1 Cursor Key Mode 

The device shall provide four keys specifically designated for 
cursor movement as up, down, left and right. If the Cursor Key 
Mode is in the reset state, these keys will transmit the 
appropriate ANSI escape sequence codes (CSI A, CSI B, CSI D, CSI 
C). If the Cursor Key Mode is in the set state, these keys will 
transmit applications function codes (SS3 A, SS3 B, SS3 D, SS3 C). 

Note that when Cursor Key Mode is in the reset state the control 
sequences transmitted by theSe keys are in fact the cursor 
movement control functions, and if echoed back to the terminal 
will cause cursor movement to occur. 
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6.8.2 Cursor Key Codes 

The codes transmitted by the Cursor Keys are not effected in any 
way by the depression of the Shift or Lock keys. 

In the following table, the first entry indicates the code 
sequence transmitted when the Cl Transmission Mode is in the reset 
state (SEVEN-BIT). The second entry indicates the code sequence 
transmitted when the Cl Transmission Mode is in the set state 
(EIGHT BIT) . 


Codes Transmitted by Cursor Keypad Keys 


Key Legend DECCKM reset 


DECCKM set 


C17 /\ (up arrow) 

1/11 5/11 4/1 (ESC [ A) 1/11 4/15 4/1 (ESC 0 A) 
9/11 4/1 ( CSI A) 8/15 4/1 ( SS3 A) 

B17 \/ (down arrow) 

1/11 5/11 4/2 (ESC [ B) 1/11 4/15 4/2 (ESC 0 B) 
9/11 4/2 ( CSI B) 8/15 4/2 ( SS3 B) 

Bl8 -> (right arrow) 

1/11 5/11 4/3 (ESC [ C) 1/11 4/15 4/3 (ESC 0 C) 
9/11 4/3 ( CSI C) 8/15 4/3 ( SS3 C) 

B16 <- (left arrow) 

1/11 5/11 4/4 (ESC [ D) 1/11 4/15 4/4 (ESC 0 D) 
9/11 4/4 ( CSI D) 8/15 4/4 ( SS3 D) 
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SET/RESET CURSOR KEY MODE DECCKM 

Levels: 1, 2 

Purpose: Cause the Cursor keys to transmit cursor control 

functions or application function codes. 


Set Format: 


CSI ? 1 h 

9/11 3/15 3/1 6/8 


Reset Format: CSI 


? 


1 


1 


9/11 3/15 3/1 


6/12 


Description: The DECCKM control is used to set or reset the 

state of Cursor Key Mode. When Cursor Key Mode is reset (Cursor), 
the Cursor keys will transmit ANSI standard cursor control 
sequences. When Cursor Key Mode is set ( Ck_Appli cation ) , the 
Cursor keys will transmit applications function codes similar to 
those transmitted by the Numeric Keypad when Keypad Mode is set 
( Kp_Appli cation) . 

Note : 


In Level 1 operation, any interaction or dependency 
between Cursor Key Mode and Keypad Mode is UNDEFINED. In 
Level 2 operation, however, it is required that these 
modes be independent of one another (i.e., it is not 
necessary to have one set in order to set the other). 

State Affected: 

CURSOR_KEY_MODE : ( CURSOR, CK_APPLICATION ) ; 

Algorithm: 

PROCEDURE SET_CURSOR_KEY_MODE; 

BEGIN 

CURSOR_KEY_MODE : - CK_APPLICATION; 

END; 


PROCEDURE RESET_CURSOR_KEY_MODE ; 
BEGIN 

CURSOR_KEY_MODE:= CURSOR; 

END; 

Known Deviations: None 
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6.9 NUMERIC KEYPAD KEYS 

The codes transmitted by these keys are not effected in any way by 
the depression of the Control, Shift or Lock keys. 


6.9.1 Keypad Application/Numeric Mode 

There are two modes of operation for the Numeric Keypad keys. 

These modes are referred to as Keypad Application Mode and Keypad 
Numeric Mode. Since they are mutually exclusive (setting one mode 
causes the other to be reset) they can be considered as two states 
of the same mode . 


6. 9. 1.1 Numeric Keypad Mode - 

When Keypad Numeric Mode is set, the keys in the Numeric Keypad 
transmit ASCII codes for the numbers 0 to 9 (3/0 to 3/9 inclusive) 
and the ASCII codes for comma, minus/hyphen, period, and carriage 
return. This setting of the mode permits the terminal user to use 
the keypad for inputting certain numeric information without 
change to application software that normally expects input from 
the main key array only. The other keys on the keypad transmit 
the SINGLE SHIFT THREE (SS3) control code followed by a single 
ASCII character indicating the key which was depressed. See the 
Numeric Keypad code tables. 


6. 9. 1.2 Application Keypad Mode - 

When Keypad Application Mode is set, all keys on the keypad 
transmit the SINGLE SHIFT THREE (SS3) control code followed by a 
single ASCII character indicating the key which was depressed. 

Note that SS3 will be transmitted as a single character code 
(8/15) when Cl Transmission Mode is set to 8-bit and as a two 
character ESC Fe sequence (ESC 0, 1/11 4/15) when set to 7-bit. 
This setting of the mode permits application software to be able 
to distinguish a keypad key from a main key array key, which is 
especially useful for applications that use the keypad as a set of 
function keys. 


BBiDDSD'' 


Digital Internal Use Only 



EL-00070-06 

VSRM - Keyboard Processing 


19-Apr-1988 


Page 6-64 


6. 9. 1.3 Numeric Keypad Key Codes - 

In the following table, the first entry indicates the code 
sequence transmitted when Cl Transmission Mode is in the reset 
(SEVEN_BIT) state. The second entry indicates the code sequence 
transmitted when Cl Transmission Mode is in the set (EIGHT_BIT) 
state . 


Codes Transmitted by Numeric Keypad Keys 


Key 

Legend 

DECKPNM 

set 

DECKPAM set 




A20 

0 

3/0 

(0) 


1/11 

4/15 

7/0 

(ESC 0 

P) 







8/15 

7/0 

( SS3 

P) 

B20 

1 

3/1 

(1) 


1/11 

4/15 

7/1 

(ESC 0 

q) 







8/15 

7/1 

( SS3 

q) 

B21 

2 

3/2 

(2) 


1/11 

4/15 

7/2 

(ESC 0 

r) 







8/15 

7/2 

( SS3 

r) 

B22 

3 

3/3 

(3) 


1/11 

4/15 

7/3 

(ESC 0 

s) 







8/15 

7/3 

( SS3 

s) 

C20 

4 

3/4 

(4) 


1/11 

4/15 

7/4 

(ESC 0 

t) 







8/15 

7/4 

( SS3 

t) 

C21 

5 

3/5 

(5) 


1/11 

4/15 

7/5 

(ESC 0 

u) 







8/15 

7/5 

( SS3 

u) 

C22 

6 

3/6 

(6) 


1/11 

4/15 

7/6 

(ESC 0 

V) 







8/15 

7/6 

( SS3 

V) 

D20 

7 

3/7 

(7) 


1/11 

4/15 

7/7 

(ESC 0 

w) 







8/15 

7/7 

( SS3 

w) 

D21 

8 

3/8 

(8) 


1/11 

4/15 

7/8 

(ESC 0 

X) 







8/15 

7/8 

( SS3 

X) 

D22 

9 

3/9 

(9) 


1/11 

4/15 

7/9 

(ESC 0 

y) 







8/15 

7/9 

( SS3 

y) 

C23 

, (comma) 

2/12 

( , ) 


1/11 

4/15 

6/12 

(ESC 0 

1) 







8/15 

6/12 

( SS3 

1) 

D23 

- (minus/hyphen) 2/13 

(-) 


1/11 

4/15 

6/13 

(ESC 0 

m) 







8/15 

6/13 

( SS3 

m) 

A22 

. (period) 

2/14 

( .) 


1/11 

4/15 

6/14 

(ESC 0 

n) 







8/15 

6/14 

( SS3 

n) 

A23 

ENTER 

same 

as 

Return 

1/11 

4/15 

4/13 

(ESC 0 

M) 







8/15 

4/13 

( SS3 

M) 

E20 

PFl 

1/11 4/15 

5/0 

1/11 

4/15 

5/0 

(ESC 0 

P) 



8/15 

5/0 


8/15 

5/0 

( SS3 

P) 

E21 

PF2 

1/11 4/15 

5/1 

1/11 

4/15 

5/1 

(ESC 0 

Q) 



8/15 

5/1 


8/15 

5/1 

( SS3 

Q) 

E22 

PF3 

1/11 4/15 

5/2 

1/11 

4/15 

5/2 

(ESC 0 

R) 



8/15 

5/2 


8/15 

5/2 

( SS3 

R) 

E23 

PF4 

1/11 4/15 

5/3 

1/11 

4/15 

5/3 

(ESC 0 

S) 



8/15 

5/3 


8/15 

5/3 

( SS3 

S) 
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6.9.2 Enter Key Operation 

When Keypad Mode is in the Numeric state, depressing the Enter key 
causes either a Carriage Return (CR, 1/13) or a Carriage 
Return/Line Peed pair ( CR LF, 0/13 0/10) to be transmitted, 
depending on the state of New Line Mode. 

When Keypad Mode is in the Application state, depressing the Enter 
key causes an escape sequence (ESC 0 M, 1/11 4/15 4/13) to be 
transmitted. See the table of Numeric Keypad keys and their 
associated codes. 
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SET KEYPAD APPLICATION MODE DECKPAM 


Levels: 1/2 

Purpose: Cause the auxiliary keypad keys to transmit control 

functions . 


Format: ESC » 

1/11 3/13 


Description: The DECKPAM control places Keypad Mode into the 

set, or 'Application' state. In this state the keys of the 
Numeric Keypad on the terminal keyboard will transmit a SINGLE 
SHIFT THREE (SS3) code followed by a single graphic code 
indicating the key which was struck. 

Notes : 

1. SINGLE SHIFT THREE (SS3) is a Cl control code which is 
transmitted as 8/15 when the Cl Transmission Mode is set 
to EIGHT_BIT, and as 1/11 4/15 ( ESC O ) when set to 
SEVEN_BIT. 

2. If the transmitted codes are echoed back to the terminal, 
or if the terminal is in local mode, the indicated 
character from the currently designated G3 set will be 
displayed; for example, when ASCII is designated as the 
G3 set, the PFl key sequence would display as ”P". 

3. In Level 1 operation, any interaction or dependency 
between Cursor Key Mode and Keypad Mode is UNDEFINED. In 
Level 2 operation, however, it is required that these 
modes be independent of one another (that is, it is not 
necessary to have one set in order to set the other). 


State Affected: 

KEYPAD MODE: (NUMERIC, KP APPLICATION); 


Algorithm: 

PROCEDURE SET_KEYPAD_APPLICATION_MODE; 
BEGIN 

KEYPAD_MODE : - KP_APPLICATION; 

END ; 

Known Deviations: None 
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SET KEYPAD NUMERIC MODE DECKPNM 

Levels: 1, 2 

Purpose: Cause the auxiliary keypad keys to transmit ASCII 

decimal digits (3/0 to 3/9). 


Format: ESC > 

1/11 3/14 


Description: The DECKPNM control places Keypad Mode into the 

reset, or 'Numeric' state. In this state the keys of the Numeric 
Keypad on the terminal keyboard will transmit a combination of 
graphic and control codes. 


Notes : 

1. In Level 1 operation, any interaction or dependency 

between Cursor Key Mode and Keypad Mode is UNDEFINED. In 
Level 2 operation, however, it is required that these 
modes be independent of one another (i.e., it is not 
necessary to have one set in order to set the other). 


State Affected: 

KEYPAD MODE: (NUMERIC, KP APPLICATION); 


Algorithm: 

PROCEDURE SET_KEYPAD_NUMERIC_MODE ; 
BEGIN 

KEYPAD_MODE:- NUMERIC; 

END ; 


Known Deviations: None 
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SET/RESET NUMERIC KEYPAD MODE DECNKM 


Levels: 2x, 3 

Purpose: Select between numeric and application keypad mode. 

This set/reset mode sequence was added to simplify inquiring the 
state of the auxiliary keypad using Terminal State Interrogation 
(TSI) functions. 


Set Format: 

CSI 

9/11 

? 

3/15 

6 

3/6 

6 

3/6 

h 

6/8 

(Application) 

Reset Format: 

CSI 

9/11 

? 

3/15 

6 

3/6 

6 

3/6 

1 

6/12 

(Numeric) 


Description: This Set/Reset mode sequence selects between having 

the auxiliary keypad keys transmit ASCII decimal digits (3/0 to 
3/9) 'Numeric' mode, or application control functions 'Application 
Mode'. The set mode sequence is equivalent to DECKPAM, and the 
reset mode sequence is equivalent to DECKPNM. 

State Affected: 

KEYPAD MODE: (NUMERIC, KP APPLICATION); 


Algorithm: 

PROCEDURE SET_KEYPAD_APPLICATION_MODE ; 
BEGIN 

KEYPAD_MODE : » KP_APPLICATION ; 

END; 


PROCEDURE SET_KEYPAD_NUMERI C_MODE ; 
BEGIN 

KE YPAD_MODE ; - NUMERI C ; 

END; 


Known Deviations: None 
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6.10 EDITING KEYPAD KEYS 

These keys transmit designated control sequences which are 
intended for editing applications. The Editing Keypad Keys are 
inoperative when pressed in combination with either the Shift or 
Control keys. 

In the following table, the first entry indicates the code 
sequence transmitted when Cl Transmission Mode is in the reset 
(SEVEN_BIT) state. The second entry indicates the code sequence 
transmitted when Cl Transmission Mode is in the set (EIGHT_BIT) 
state . 

In Level 1 operation, the Editing Keypad keys are inoperative 
(transmit nothing, and do not keyclick). In Level 2 operation, 
the Editing Keypad keys transmit a control sequence with a single 
digit parameter indicating the key. 


Codes Transmitted by Editing Keypad Keys 


Key 

Id Legend Codes Generated (Level 2 only) 


E16 Find 1/11 


E17 

Insert 

Here 

1/11 

E18 

Remove 

1/11 

D16 

Select 

1/11 

D17 

Prev 

Screen 

1/11 

D18 

Next 

Screen 

1/11 


5/11 

3/1 

7/14 

(ESC ( 

1 

~) 

9/11 

3/1 

7/14 

( CSI 

1 

~) 

5/11 

3/2 

7/14 

(ESC ( 

2 

") 

9/11 

3/2 

7/14 

( CSI 

2 

~) 

5/11 

3/3 

7/14 

(ESC { 

3 

~) 

9/11 

3/3 

7/14 

( CSI 

3 

~) 

5/11 

3/4 

7/14 

(ESC [ 

4 

~) 

9/11 

3/4 

7/14 

( CSI 

4 

~) 

5/11 

3/5 

7/14 

(ESC [ 

5 

~) 

9/11 

3/5 

7/14 

( CSI 

5 

~) 

5/11 

3/6 

7/14 

(ESC t 

6 

~) 

9/11 

3/6 

7/14 

( CSI 

6 

~) 
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6.11 APPLICATION FUNCTION KEYS 

Application Function Keys are all the keys in the upper row which 
are not explicitly designated as Local Function Keys (all keys but 
the left five keys in the row). These keys transmit designated 
control sequences which are intended for use by operating systems 
and applications programs. The Permanent and Removable (System 
and Application) Label Strips serve as legends for these keys. 

The specific meaning of these keys is not defined by the 
architecture, and will vary from product to product. However, the 
codes transmitted by these keys will not change due to their 
usage . 

When the Application Function keys are depressed in combination 
with the Shift Key, they transmit User Defined Key (UDK) sequences 
whose definitions have been previously received. See the section 
"User Defined Keys Extension" for a complete description of this 
Level 2 function. Note that if the UDK extension is not 
supported, the Application Function Keys in combination with Shift 
will not transmit anything. The codes transmitted by the 
Application Function keys are not affected in any way by the 
depression of the Lock key. When the Application Function keys 
are pressed in combination with the Control key, they are 
inoperative (no code is transmitted). 

In the following table, the first entry indicates the code 
sequence transmitted when Cl Transmission Mode is in the reset 
(SEVEN_BIT) state. The second entry indicates the code sequence 
transmitted when Cl Transmission Mode is in the set (EIGHT_BIT) 
state . 

In Level 1 operation, only the Gll, G12, and G13 keys are active 
as ESC, BS, and LF, respectively; the remaining Application 
I Function Keys are inoperative (transmit nothing, and do not 
I keyclick). In Level 1 operation Gll, G12 and G13 transmit nothing 
I and do not click if either the shift key or control key are 
I depressed when either ESC, BS, or LF are also depressed. When the 
operating mode is set to Level 2, the Application Function Keys 
transmit a control sequence with a two-digit parameter indicating 
the key. 
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Codes Transmitted by Application Function Keys 


Key 

Permanent 
Label Strip 

Level 1 

Level 2 







G05 

F6 


1/11 

5/11 

3/1 

3/7 

7/14 

(ESC [ 

17 

~) 





9/11 

3/1 

3/7 

7/14 

( CSI 

17 

~) 

GO 6 

F7 

- 

1/11 

5/11 

3/1 

3/8 

7/14 

(ESC ( 

18 

~) 





9/11 

3/1 

3/8 

7/14 

( CSI 

18 

") 

G07 

F8 

- 

1/11 

5/11 

3/1 

3/9 

7/14 

(ESC [ 

19 

~) 





9/11 

3/1 

3/9 

7/14 

( CSI 

19 

~) 

GOO 

F9 

- 

1/11 

5/11 

3/2 

3/0 

7/14 

(ESC ( 

20 

~) 





9/11 

3/2 

3/0 

7/14 

( CSI 

20 

~) 

G09 

FlO 

- 

1/11 

5/11 

3/2 

3/1 

7/14 

(ESC [ 

21 

~) 





9/11 

3/2 

3/1 

7/14 

( CSI 

21 

~) 

Gll 

Fll (ESC) 

1/11 

1/11 

5/11 

3/2 

3/3 

7/14 

(ESC ( 

23 

~) 





9/11 

3/2 

3/3 

7/14 

( CSI 

23 

~) 

G12 

F12 (BS) 

0/8 

1/11 

5/11 

3/2 

3/4 

7/14 

(ESC [ 

24 

~) 





9/11 

3/2 

3/4 

7/14 

( CSI 

24 

~) 

G13 

F13 (LF) 

0/10 

1/11 

5/11 

3/2 

3/5 

7/14 

(ESC f 

25 

~) 





9/11 

3/2 

3/5 

7/14 

( CSI 

25 

~) 

G14 

F14 

- 

1/11 

5/11 

3/2 

3/6 

7/14 

(ESC t 

26 

~) 





9/11 

3/2 

3/6 

7/14 

( CSI 

26 

~) 

G15 

(F15) 

— 

1/11 

5/11 

3/2 

3/8 

7/14 

(ESC I 

28 

~) 





9/11 

3/2 

3/8 

7/14 

( CSI 

28 

~) 

G16 

(F16) PO 

- 

1/11 

5/11 

3/1 

3/9 

7/14 

(ESC I 

29 

~) 





9/11 

3/2 

3/9 

7/14 

( CSI 

29 

~) 

G20 

F17 

— 

1/11 

5/11 

3/3 

3/1 

7/14 

(ESC ( 

31 

~) 





9/11 

3/3 

3/1 

7/14 

( CSI 

31 

~) 

G21 

F18 

- 

1/11 

5/11 

3/3 

3/2 

7/14 

(ESC ( 

32 

~) 





9/11 

3/3 

3/2 

7/14 

( CSI 

32 

~) 

G22 

F19 

- 

1/11 

5/11 

3/3 

3/3 

7/14 

(ESC [ 

33 

~) 





9/11 

3/3 

3/3 

7/14 

( CSI 

33 

~) 

G23 

F20 

- 

1/11 

5/11 

3/3 

3/4 

7/14 

(ESC ( 

34 

~) 





9/11 

3/3 

3/4 

7/14 

( CSI 

34 

~) 
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6.12 LOCAL FUNCTION KEYS 

The Local Function Keys are the left five keys in the Function Key 
I Row, having positions G99, GOO, GOl, G02, and G03. The codes for 
I these keys shall not be transmitted by any terminal products to a 
host system. Their use is reserved exclusively for product 
specific local functions. 

The use of Local Function Keys shall be implementation defined and 
registered with the architecture. When a previously defined 
function is implemented in a product, it shall be implemented as 
defined, and in the defined key position (insofar as this is 
possible where multiple definitions do not produce conflict). 

See Appendix D "Documented Exceptions" for a description of the 
designated codes to be used for the Local Function Keys when they 
are implemented internally to a product, such as a Personal 
Computer or Workstation. 


6.12.1 Hold Screen Key Operation 

I When the currently selected communications protocol supports some 
I form of flow control, typing this key will toggle the screen 

I hold/no hold. When the toggle is set to "no hold", the Hold 

Screen LED will be off, and screen operation will be normal. When 
the toggle is set to "Hold", the Hold Screen LED will be on, and 
the screen will freeze. (The screen will not be updated further 
and no more scrolling will occur). Typing the Hold Screen key 
when the screen is held will allow scrolling to begin again. 

I The Hold Screen function should be implemented so that it operates 
I regardless of whether the Hold Screen key is depressed alone, or 
I in combination with the Shift or Control Keys. In terminals that 

I implement the Multiple Sessions extension, such as the VT330/340, 

I pressing Hold Screen in combination with the CTRL Key will hold 
I all sessions. 

If the currently selected communications protocol does not support 
the Hold Screen function, the Hold Screen key will be inoperative. 

I See DEC STD 070-12 Terminal Synchronization for information on the 
interaction between Hold Screen and communications flow control. 


TM 
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6.12.2 Print Screen Key Operation 

For a complete description of the printer modes and data transfer 
operations, see DEC STD 070-7 Printer Port Extension . 

a. PRINT alone prints a copy of the cell text data in the 
region of the character cell display defined by Print 
Extent Mode (either the entire character cell display, or 
the character cell display scrolling region) to the 
printer port. 

b. SHIFT/PRINT prints a copy of the entire character cell 
display bitmap to the printer port (binary transfer). 

c. CONTROL/PRINT toggles Auto Print Mode. 


6.12.3 Set-Up Key Operation 

Depression of the Set-Up Key, either alone or in combination with 
the Shift or Control Keys, causes the terminal to enter into a 
local mode of operation in which certain terminal state may be 
changed by the User. Keyboard operation and screen display in 
Set-Up Mode is beyond the scope of this architecture 
specification, as is the means by which the terminal returns to 
normal operation, and the state which gets restored. 


6.12.4 Local Function Key F4 

6.12.4.1 Switch Session Key Operation - The Switch Session Key 
(F4) is used by terminals with the Multiple Sessions extension 
(VT330/340) to switch between sessions. 

a. Switch Session or Shift/Switch Session instructs the 
terminal to activate another session. Refer to the 
Session Management chapter. 

b. CTRL/Switch Session instructs the terminal to select one 
of a number of presentation states. Refer to the 
Presentation Management chapter. 


6.12.4.2 Data/Talk Key Operation - Terminals with an integral 
modem (option on VT220), may use F4 as a Data/Talk switch for the 
modem. Pressing F4 alone will toggle between the Data and Talk 
modes. The Data mode is used for data communications once a 
connection is established. Talk mode is used for dialing or 
normal conversation with the attached telephone. 
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I 6.12.4.3 F4 Operation When Not Used For Local Function - If not 
I used for a local function, F4 shall be dead (shall not transmit 
I anything to the host). 


6.12.5 Break Key Operation 

For a complete description of the communications functions, see 
DEC STD 070-12 Terminal Synchronization , DEC STD 070-4 Terminal 
Management, and DEC STD 070-3 Code Extension Layer. 

I 

I 1. BREAK alone transmits a break if break is enabled (an 

I optional set-up feature may be provided to disable the 

I break function) . 

2. SHIFT/BREAK performs a disconnect if disconnects are 
enabled. 

3. CONTROL/BREAk sends the terminal answerback message to 
the host. 
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6.13 MAIN KEY ARRAY - SPECIAL KEYS AND FUNCTIONS 

The following keys are "special keys" on the Main Key array. They 
perform special actions or are otherwise unique. They are each 
found on all versions of the keyboard. 

Four of the keys do not cause bytes to be immediately transmitted 
across the coding interface; rather, they condition the effect of 
other keys at the same time and/or subsequently. These keys are 
not auto-repeatable. The keys are; 


1. Control 

2. Shift 

3. Lock 

4. Compose 


The remaining four keys send a particular ASCII control character 


or SPACE 

. All but the 

Return key are 

auto- 

repeatable 

. They are 



Normal 

Control Shift 

Lock 

1. 

Space Bar 

2/0 

0/0 

2/0 

2/0 

2. 

Return 

0/13* 

0/13* 

0/13* 

0/13* 

3. 

Tab 

0/9 

0/9 

0/9 

0/9 

4. 

Delete 

7/15 

1/8 

7/15 

7/15 

* When New Line Mode is 

set (New Line 

On) , 

the two-byte sequence 


0/13 0/10 is transmitted. 


6.13.1 Control Key Operation 

When the Control key is held down while another key is depressed 
which forms a legal control combination, there is one keyclick and 
the appropriate control code is transmitted. All of the 32 ASCII 
CO control codes plus DELETE (7/15) can be generated by typing the 
A-Z keys or the 2-8 keys independent of the Shift key or Lock key. 
In addition to the 2-8 keys, the keyboard provides alternative 
forms for keying the CO controls for backward compatibility with 
DEC STD 107 and ANSI X4.14 (now superseded by X4. 23-1982). On 
non-US keyboards, these alternate forms are provided whenever the 
keys involved in these combinations are present. 
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Valid control combinations auto repeat the same as other 
repeatable keys. If Control is pressed while a key is repeating, 
and the key forms a valid control combination, the key will 
continue to repeat but transmit the control combination while the 
Control key is pressed. If the key does not form a valid control 
combination, the key will stop repeating while the Control key is 
pressed. 

When the Control key is depressed, the Shift key is ignored. On 
European keyboards with the numbers in shifted positions, the 
Ctrl-number construction does not require the use of shift. This 
applies to the number keys only. In the case where the numeral 
legends are shifted, and the number forms a valid control code, 
the unshifted legend is ignored. If the number has no meaning 
with CTRL, then the lower character on the key (such as [ ) is 

used. Exception; Tilde (EOO) on the North American keyboard is 
used even though it is the upper character. 

Guideline: On the French keyboard, typing CTRL/E06 (unshifted 

legend shifted legend "6") will generate the control code for 

CTRL-6. On the Italian Keyboard in DP mode, CTRL-9 is not 
defined, so the key sends CTRL-( (ESC) because that is the 
unshifted legend on the key, and the "[" character forms a valid 
control combination. 

The valid control combinations are standard across all keyboards. 
Refer to the "Control Codes and Keystrokes" section later in this 
chapter. 

Invalid control combinations (any not listed below) will result in 
no keyclick occurring and no code being transmitted. 

Note 1; El to E6 (the editing keypad), F6 to F20 (the top row 
function keys) and the cursor keys are dead when used with the 
CTRL key. 

Note 2; The CTRL key is ignored when used with the numeric keypad 
keys. 

Note 3: When using some communications protocols, certain of the 
control characters may not be allowed, for example, ctrl/S and 
ctrl/Q (XON and XOFF). In this case the control characters are 
considered as Local Function Keys. Conforming software should not 
use ctrl/s and ctrl/Q because of their possible use in 
communications flow control. See DEC STD 070-12 Terminal 
Synchronization for a complete description of the use of these 
characters . 
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6.13.2 Shift Key Operation 

In order to obtain a shifted character, the Shift key and the 
graphic character key must be depressed together. Shift only 
applies to keys which produce graphic characters on the main key 
array. The state of the Shift key is ignored when any other key 
on the main array is depressed, including the Space Bar, Return, 
Tab, Delete keys. The use of the Control key supersedes the Shift 
key, so that the same control characters are generated whether the 
key is also shifted or not. 

Shift has no effect on the codes transmitted by the Numeric Keypad 
keys and the Cursor Keys. When Function keys are depressed in 
combination with the Shift key, they transmit User Defined Key 
(UDK) sequences whose definitions have been previously received. 
The Editing keypad keys are inoperative when pressed in 
combination with the Shift key. 


6.13.3 Lock Key Operation 

The LOCK key is used to enter Shift Lock Mode or Caps Lock Mode. 

If a Shift Lock keyboard is selected in Set-Up: Shift Lock mode 
is turned on by pressing the LOCK key, and turned off by pressing 
either the LOCK key or a SHIFT key. If a Caps Lock keyboard is 
selected in Set-Up: Caps Lock Mode is toggled on or off by 
pressing the LOCK key. 

The LOCK key operates at all times regardless of any other keys 
being held down. 

The terminal user may set Caps/Shift Lock Mode to either Caps Lock 
Operation or Shift Lock Operation as a Set-Up feature. The 
factory default is Caps Lock Operation to be compatible with the 
VTIOO. 
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6.13.3.1 Shift Lock Operation - 

When Caps/Shift Lock Mode is set to Shift Lock Operation all 
normal characters are acted on as if the Shift key were being 
depressed at the same time as the keystroke. The normal 
characters are those characters which are listed in the tables of 
alpha-numeric keyboard maps. Not included are control characters, 
tab, function keys, delete, return, compose, enter, lock, and 
shift keys. Note: when Shift Lock Operation is in effect, unless 
an implied or explicit compose sequence is used, it is not 
possible to generate the upper case characters using: 


a. The keys that have one lower case letter legend and 
another legend. 

b. The keys that have two lower case letter legends. 


6.13.3.2 Caps Lock Operation - 

When Caps/Shift Lock Mode is set to Caps Lock Operation, keys 
whose shifted and unshifted characters are the upper and lower 
case form of a single alphabetic letter transmit the shifted 
(upper case) character (as if the Shift key were being held down). 
Keys affected' by Caps Lock are those with upper case alphabetic 
legends on the corresponding keyboard. Keys with one or two lower 
case (small letter) legends are not effected by Caps Lock 
Operation. 


mmn 
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6.13.4 SPACE Bar Operation 

The Space Bar usually causes the SPACE code (SP 2/0) to be 
transmitted. It can also be used in some explicit and implied 
compose sequences in order to represent a free standing accent as 
the equivalent ASCII code for a spacing character. Ctrl-space 
will send a NUL. 


6.13.5 Return Key Operation 

Depressing the Return key causes either a Carriage Return (CR, 
0/13) or a Carriage Return/Line Feed pair (CR LF, 0/13 0/10) to be 
transmitted, depending on the state of New Line Mode. 


6.13.5.1 New Line Mode - 

A conforming device shall provide a means of selecting the codes 
transmitted as a result of depressing the Return and Enter keys on 
the keyboard. Normally these keys will both transmit a Carriage 
Return character (0/13) [reset state » no_new_line ] . When this 
mode is in the set state [set state » new_line] these keys will 
both generate a two-code sequence 1/13 1/10 ( CR LF ) . 

NEW_LINE_MODE: (NEW_LINE_OFF,NEW_LINE_ON) ; 

Note that New Line Mode is a function of the Character Cell 
Display architecture since it also causes receipt of LF to be 
interpreted as if it were CR LF, and is fully defined in that 
specification. 

Note also that New Line Mode does not effect the code transmitted 
when the M key is pressed while holding the Control key. ctrl/M 
always transmits just 0/13. 

Deviation Note: In the VTlOO, VTlOl, VT102, VT125, VT131, and 
VT132, the M key in combination with the Control Key IS effected 
by New Line Mode, and sends the sequence 0/13 0/10 when New Line 
Mode is in the set (New Line On) state. 
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6.13.6 Tab Key Operation 

Typing the Tab key causes a horizontal tabulation code (HT, 0/9) 
to be transmitted. 


6.13.7 Delete Key Operation 

The Delete key usually causes a Delete code (DEL, 7/15) to be 
generated. The exception is that during an explicit or implied 
compose sequence it aborts the compose sequence in progress, 
cancels compose mode, and no code is transmitted. The delete key 
still clicks if keyclick is enabled. 

I 

I Guideline: VT300 series terminals provide a Set-Up option to 
I allow the Backarrow key "<X]" to transmit Delete (7/15) or 
I Backspace (0/8). 


6.13.8 Compose Key Operation 

The Compose key permits generation of additional characters not 
present on the keyboard as a sequence of three key strokes. Its 
operation is described in the section on Compose Operation since 
I the sequences include graphic keys. An optional set-up feature 
I may be provided to disable the compose key. 


6.13.9 Non-Spacing Diacritical Keys 

On most non-US keyboards, certain accents are provided as 
Non-spacing Diacritical Keys, depending on the language or 
languages of the country. These keys serve both to enter an 
implied compose mode and to indicate the accent to be used with 
I the following letter key. The operation of Non-Spacing 
I Diacritical keys is further described in the "Compose Operation" 
I subsection below. 
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6.14 MAIN KEY ARRAY - GRAPHIC CHARACTER KEYS 

I This section describes the graphic characters produced by keys in 
I the main key array. Graphic character keys are all keys on the 
main key array which transmit character codes in the range 2/1 to 
7/14 inclusive, and 10/0 to 15/15 inclusive. The Space bar 
transmits 2/0 and is used along with graphic characters in compose 
sequences. 

I The tables in this section associate each alpha-numeric key 
I (described by position on the Keyboard Position Map) with a unique 
I character (by name) for shifted and unshifted modes. The actual 
I code produced is a function of the character encoding. 

I Level 3 terminals, and Level 2 terminals with the 8-bit 
I Architecture Extension, support two different 8-bit multinational 
I character encodings. Level 2 and Level 3 terminals with the NRCS 
I Extension also support a number of 7-bit country specific 
I (National) character encodings. At any time, only one of these 

I character encodings is in use. The user can choose one of the 
I following keyboard encodings via Set-Up: 

I - DEC Multinational (factory default) 

I SET-UP: 8-bit Characters, UPSS DEC Multinational 

I Primary keyboard set is ASCII 

I Supplemental keyboard set is DEC Supplemental 

I - ISO Latin' Alphabet Nr 1 

I SET-UP: 8-bit Characters, UPSS ISO Latin-1 

I Primary keyboard set is ASCII 

I Supplemental keyboard set is ISO Latin-1 supplemental 

I - 7-bit ASCII character set 

I SET-UP: 7-bit Characters, Data Processing Keys 

I Primary keyboard set is ASCII 

I No supplemental characters available 

I - 7-bit National Replacement Character Set (NRCS) 

I SET-UP: 7-bit Characters, Typewriter Keys 

I Primary keyboard set is one of 12 NRCS 

I No supplemental characters available 

I The selection of a particular 7-Bit NRCS is bound to the selection 
I of the keyboard dialect (Guideline: The VT320 uses 12 NRC sets to 
I support 16 keyboard dialects). In 7-bit Characters mode, choosing 
I Data Processing Keys always uses ASCII as the primary keyboard 
set. 


Deviation Note 

Older Level 2 terminals did not always use ASCII 
as the primary keyboard set when Data Processing 
Keys was selected (prior to the VT220CR) . This 
use of a 7-bit NRCS other than ASCII in 7-bit 
Characters Data Processing mode has been 
deprecated. 
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For information on character sets and coding, refer to DEC STD 
169. 

Some character codes are included in these tables for characters 
whose coding might otherwise be confusing. These codes are given 
in row/column notation. The character encoding should be clear 
from the context as described above (8-bit Characters mode is 
always given in ISO Latin Alphabet Nr. 1). 

There are four tables for each Keyboard Dialect; 

a. 8-bit Characters, Typewriter Keys 

b. 8-bit Characters, Data Processing Keys 

c. 7-bit Characters, Typewriter Keys (NRCS) 

d. 7-bit Characters, Data Processing Keys (ASCII) 


Some keyboard dialects have changed to accomodate more recent 
country requirements. The most recent or recommended tables are 
listed first for each dialect, followed optionally by superseded 
tables included for reference. 

A character name enclosed in square brackets [ ] indicates that the 
key is a Non-Spacing Diacritical key which when combined with 
another key forms a two key implied compose sequence. 

The following rules of precedence are applied; 

1. The unshifted character is generated when neither 
Control, Shift, Shift-Lock, nor Caps-Lock are in effect. 

2. When Caps-Lock is in effect, and the Shifted and 
Unshifted characters are the upper and lowercase form of 
a single alphabetic letter, the shifted character is 
generated. 

3. When Shift is in effect, it overrides Caps-Lock (always 
generates the shifted character). 

4. When Control is in effect, it overrides Shift, 

Shift-Lock, and Caps-Lock. Refer to the "Control Codes 
and Keystrokes" subsection later in this chapter. 
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6.14.1 North 

American Keyboard (LK201 

.-EE US/UK, LK201-NA, 

LK201- 

-AA) 


8-bit Characters, Typewriter Keys 


Position 

Unshifted 

Shifted 

EOO 

' Open quote 

~ Tilde character 

EOl 

1 

! Exclamation point 

E02 

2 

@ Commercial at 

E03** 

3 

# Number sign 

E04 

4 

$ Dollar sign 

E05 

B 

% Percent sign 

E06 

6 

" Circumflex characte: 

E07 

7 

& Ampersand 

E08 

8 

* Asterisk 

E09 

9 

( Opening parenthesis 

ElO 

0 

) Closing parenthesis 

Ell 

- Hyphen, Minus 

Underline 

E12 

- Equals 

+ Plus 

DOl 

q 

Q 

D02 

w 

w 

D03 

e 

E 

D04 

r 

R 

DOB 

t 

T 

D06 

y 

Y 

D07 

U 

U 

D08 

i 

I 

D09 

o 

0 

DIO 

p 

P 

Dll 

[ Opening bracket 

{ Opening brace 

D12 

] Closing bracket 

} Closing brace 

COl 

a 

A 

C02 

s 

S 

C03 

d 

D 

C04 

f 

F 

COB 

g 

G 

C06 

h 

H 

C07 

j 

J 

C08 

k 

K 

C09 

1 

L 

CIO 

; Semicolon 

: Colon 

Cll 

' Apostrophe 

” Quotation marks 

C12 

\ Backslash 

1 Vertical line 

BOO 

< Less Than 

> Greater than 

BOl 

z 

Z 

B02 

X 

X 

B03 

c 

C 

B04 

V 

V 

BOB 

b 

B 

B06 

n 

N 

B07 

m 

M 

BOS 

, Comma 

, Comma 

B09 

. Period 

• Period 

BIO 

/ Slash 

? Question mark 


mmu 
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North American Keyboard, 8-bit Characters, Data Processing Keys 
Equivalent to 8-bit Characters, Typewriter Keys 


North American Keyboard, 7-bit Characters, Typewriter Keys 

7-bit Characters mode is not available with the North American 
keyboard dialect, although certain conditions can restrict the 
keyboard to sending 7-bit characters. In this case, the layout is 
the same as for 8-bit Characters. 


North American Keyboard, 7-bit Characters, Data Processing Keys 
Equivalent to 7-bit Characters, Typewriter Keys 


The LK201-NA is for use with the VT330/340 series terminals and 
has front legends on the editing and numeric keypad not found on 
the LK201-EE. 

There are three legends on E03 (LK201-EE LK201-NA combined US/UK), 
the shifted code generated by this key is dependent upon which 
dialect. North American or British, is selected in set-up. 


man' 
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6.14.2 British Keyboard (LK201-EE US/UK) 


8-bit Characters, Typewriter Keys 
Position Unshifted 


EOO 


EOl 

1 

E02 

2 

E03** 

3 

E04 

4 

EOS 

5 

E06 

6 

E07 

7 

E08 

8 

E09 

9 

ElO 

0 

Ell 

— 

E12 

a 

DOl 

q 

D02 

w 

D03 

e 

D04 

r 

DOS 

t 

D06 

y 

D07 

u 

D08 

i 

D09 

o 

DIO 

P 

Dll 

( 

D12 

I 

COl 

a 

C02 

s 

C03 

d 

C04 

f 

COS 

9 

C06 

h 

C07 

j 

C08 

k 

C09 

1 

CIO 

i 

Cll 

f 

C12 

\ 

BOO 

< 

BOl 

z 

B02 

X 

B03 

c 

B04 

V 

BOS 

b 

B06 

n 

B07 

m 

BOS 

9 

B09 

• 

BlO 

/ 


Open quote 


Hyphen, Minus 
Equals 


Opening bracket 
Closing bracket 


Semicolon 
Apostrophe 
Backslash 
Less Than 


Comma 

Period 

Slash 


Shifted 


i 

@ 

£ 

$ 

% 

A 

& 

* 

( 

) 

+ 

Q 

W 

E 

R 

T 

Y 

U 

I 

O 

P 

{ 

} 

A 

S 

D 

F 

G 

H 

J 

K 

L 


I 

> 

Z 

X 

c 

V 

B 

N 

M 


? 


Tilde character 
Exclamation point 
Commercial at 
British pound (10/3) 
Dollar sign 
Percent sign 
Circumflex character 
Ampersand 
Asterisk 

Opening parenthesis 
Closing parenthesis 
Underline 
Plus 


Opening brace 
Closing brace 


Colon 

Quotation marks 
Vertical line 
Greater than 


Comma 

Period 

Question mark 


-85 


EBB 
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British Keyboard, 8-bit Characters, Data Processing keys 
Equivalent to 8-bit Characters, Typewriter keys 

British Keyboard, 7-bit Characters, Typewriter Keys 
(Where different from 8-bit Characters, Typewriter keys) 

Position Unshifted Shifted 

E03 3 £ British pound (2/3) 

British Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 

Position Unshifted Shifted 

E03 3 # Number sign (2/3) 

There are three legends on E03, the shifted code generated by this 
key is dependent upon which dialect. North American or British, is 
selected in set-up. 
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6.14. 

S British Keyboard (LK201-AE) 


8-bit 

Characters, Typewriter Keys 


Position Unshifted 

Shifted 

EOO 

[Tilde mark] 

® Degree sign 

EOl 

1 

! Exclamation point 

E02 

2 

" Double quote 

EOS 

S 

£ British pound (10/S) 

E04 

4 

$ Dollar sign 

E05 

B 

% Percent sign 

E06 

6 

& Ampersand 

E07 

7 

' Apostrophe 

EOO 

8 

( Open parenthesis 

E09 

9 

( Close parenthesis 

ElO 

0 

= Equals 

Ell 

- Hyphen, Minus 

Underline 

E12 

*5 one-half 

h one-qrtr 

DOl 

q 

Q 

D02 

w 

w 

DOS 

e 

E 

D04 

r 

R 

DOB 

t 

T 

D06 

y 

Y 

D07 

U 

U 

DOS 

i 

I 

D09 

0 

0 

DIO 

p 

p 

Dll 

@ Commercial at 

§ Section sign 

D12 

] Close bracket 

[ Open bracket 

COl 

a 

A 

C02 

s 

S 

COS 

d 

D 

C04 

f 

F 

COB 

g 

G 

C06 

h 

H 

C07 

j 

J 

COS 

k 

K 

C09 

1 

L 

CIO 

; Semicolon 

+ Plus 

Cll 

; Colon 

* Asterisk 

C12 

[Circumflex accent] 

[Grave accent] 

BOO 

< Less Than 

> Greater than 

BOl 

z 

Z 

B02 

X 

X 

BOS 

c 

c 

B04 

V 

V 

BOB 

b 

B 

B06 

n 

N 

B07 

m 

M 

BOS 

, Comma 

, Comma 

B09 

. Period 

. Period 

BIO 

/ Slash 

? Question mark 


BiismsD 
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British Keyboard, 8-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position 


Unshifted 


E03 

Dll 


3 

@ 


Shifted 


# Number sign (2/3) 
\ Backslash 


British Keyboard, 7-bit Characters, Typewriter Keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

E03 

C12 


Tilde 

3 

Circumflex Character 


Dead 

£ British pound (2/3) 
' Open quote 


British Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 

Position Unshifted Shifted 


EOO 

E03 

Dll 

C12 


Tilde 

3 

e 

^ Circumflex Cha 


Dead 

Dead 

\ Backslash 
ter ' Open quote 


TM . 
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6.14. 

4 Flemish Keyboard (LK201-AB) 




8-bit 

Characters, Typewriter Keys 




Position Unshifted 


Shifted 

EOO 

[Grave accent] 


[Tilde mark] 

EOl 

& Ampersand 


1 


E02 

e Small e with acute 

(14/9) 

2 


E03 

" Quotation marks 


3 


E04 

' Apostrophe 


4 


E05 

( Opening parenthesis 


5 


E06 

§ Section sign 

(10/7) 

6 


E07 

e small e with grave 

(14/8) 

7 


E08 

1 Exclamation point 


8 


E09 

9 Small c with Cedilla 
a Small a with grave 

(14/7) 

9 


ElO 

(14/0) 

0 


Ell 

) Closing parenthesis 


0 

Degree sign (11/0) 

E12 

- Hyphen, Minus 



Underline 

DOl 

a 


A 


D02 

z 


Z 


DO 3 

e 


E 


DO 4 

r 


R 


DOS 

t 


T 


D06 

y 


Y 


D07 

U 


U 


D08 

i 


I 


D09 

* 0 


0 


DIO 

p 


p 


Dll 

[Circumflex accent] 


[ Dieresis ] 

D12 

$ Dollar sign 


* 

Asterisk 

COl 

q 


Q 


C02 

s 


S 


C03 

d 


D 


C04 

f 


F 


COS 

g 


G 


C06 

h 


H 


C07 

j 


J 


C08 

k 


K 


C09 

1 


L 


CIO 

m 


M 


Cll 

u Small u with grave 

(15/9) 

% 

Percent sign 

C12 

# Number sign 



Commercial at sign 

BOO 

< Less Than 


> 

Greater than 

BOl 

w 


W 


B02 

X 


X 


B03 

c 


c 


B04 

V 


V 


BOS 

b 


B 


B06 

n 


N 


B07 

, Comma 


p 

Question mark 

BOS 

; Semicolon 


• 

Period 

B09 

: Colon 


/ 

Slash 

BlO 

= Equals 


+ 

Plus 


BOB 
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Flemish Keyboard, 8-bit Characters, Data Processing Keys 
(Where different from 8-bit Characters, Typewriter keys) 

Position Unshifted Shifted 


E06 

[ 

Opening bracket 

E07 

] 

Closing bracket 

Cll 

\ 

Backslash 


6 

7 

% Percent sign 


Flemish Keyboard, 7-bit Characters, Typewriter Keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position 

Unshifted 



Shifted 

EOO 

[Grave accent] 


Dead 

E02 

e Small e 

with acute 

(7/11) 

2 

E06 

S Section 

sign 

(5/13) 

6 

E07 

e small e 

with grave 

(7/13) 

7 

E09 

9 Small c 

with Cedilla 

(5/12) 

9 

ElO 

a Small a 

with grave 

(4/0) 

0 

Ell 

) Closing 

parenthesis 


® Degree sign 

Cll 

u Small u 

with grave 

(7/12) 

% Percent sign 

C12 

Dead 



Dead 

Flemish 

Keyboard, 7-bit 

Characters, 

Data Processing Keys 


(Where different from 8-bit Characters, Typewriter keys) 


(5/11) 


Position Unshifted 


Shifted 


EOO 

E02 

E06 

E07 

E09 

ElO 

Ell 

Dll 

Cll 


' Open quote 
Dead 

( Opening bracket 
] Closing bracket 
Dead 
Dead 

) Closing parenthesis 
~ Circumflex character 
\ Backslash 


Tilde character 

2 

6 

7 

9 

0 


Dead 

" Quotation marks 
% Percent sign 


BDaggnD 


Digital Internal Use Only 



EL-00070-06 


19- 

Apr-1988 


Page 6-91 

VSRM - 

Keyboard 

Processing 





6.14.5 

Canadian 

1 (French) Keyboard 

(LK201-AC) 

8-bit 

Characters 

Typewriter 

Keys 




Position Unshifted 



Shifted 

EOO 

[Tilde mark] 



0 

Degree sign (11/0) 

EOl 

1 




1 

• 

Exclamation mark 

E02 

2 




ft 

Quotation marks 

E03 

3 




/ 

Slash 

E04 

4 




$ 

Dollar sign 

EOS 

5 




% 

Percent sign 

E06 

6 




? 

Question mark 

E07 

7 




& 

Ampersand 

EOS 

8 




* 

Asterisk 

E09 

9 




( 

Opening parenthesis 

ElO 

0 




) 

Closing parenthesis 

Ell 

- 

Hyphen, Minus 




Underline 

E12 

« 

Equals 



+ 

Plus 

DOl 

q 




Q 


D02 

W 




w 


D03 

e 




E 


D04 

r 




R 


DOS 

t 




T 


D06 

y 




Y 


D07 

U 




U 


DOS 

i 




I 


D09 

■ o 




0 


DIO 

p 




p 


Dll 

9 

Small c w/Cedilla 

(14/7) 

? 

Capital C w/Cedilla (12/7) 

D12 

# 

Number sign 




Commercial at 

COl 

a 




A 


C02 

s 




s 


C03 

d 




D 


C04 

f 




F 


COS 

g 




G 


C06 

h 




H 


C07 

j 




J 


COS 

k 




K 


C09 

1 




L 


CIO 

• 

f 

Semicolon 



• 

• 

Colon 

Cll 

[Grave accent] 



[Circumflex accent] 

C12 

\ 

Backslash 



1 

Vertical line 

BOO 

< 

Less Than 



> 

Greater than 

BOl 

z 




z 


B02 

X 




X 


B03 

c 




c 


B04 

V 




V 


BOS 

b 




B 


B06 

n 




N 


B07 

in 




M 


BOS 

f 

Comma 



f 

Apostrophe 

B09 

• 

Period 




Period 

BIO 

e 

Small e with 

acute 

(14/9) 

E 

Capital E with acute (12/9) 

SDSDOSgi 

TM 
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Canadian (French) Keyboard, 8-bit Characters, Data Processing Keys 
(Where different from 8-bit Characters, Typewriter keys) 

Position Unshifted Shifted 

Dll 1 Closing bracket [ Opening bracket 


Canadian (French) Keyboard, 7-bit Characters, Typewriter Keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position 


Unshifted 


Shifted 


EOO 

Dll 

D12 

C12 

BIO 


Dead 


Dead 

9 Small c w/Cedilla 

(5/12) 

Dead 

# Number sign 


Dead 

Dead 


Dead 

e Small e with acute 

(7/11) 

Dead 


Canadian (French) Keyboard, 7-bit Characters, Data Processing Keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position 


Unshifted 


Shifted 


EOO ~ Tilde char 

Dll ] Closing bracket 

Cll ' Open Quote 

BIO Dead 


Dead 

[ Opening bracket 
'' Circumflex Char 
Dead 


TM 
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6.14.6 

Danish Keyboard (2nd, LK201-ED) 




8-bit 

Characters 

Typewriter Keys 




Position Unshifted 

Shifted 


1 EOO 

~ 

Tilde Char 

S 

Section sign (10/7) 


EOl 

1 


1 

Exclamation mark 


E02 

2 


If 

Quotation marks 


1 EOS 

S 


£ 

Pound sign (10/S) 


E04 

4 


$ 

Dollar sign 


E05 

B 


% 

Percent 


E06 

6 


& 

Ampersand 


E07 

7 


/ 

Slash 


E08 

8 


( 

Opening parenthesis 


E09 

9 


) 

Closing parenthesis 


ElO 

0 


* 

Equals 


Ell 

+ 

Plus 

? 

Question mark 


1 E12 

r 

Apostrophe 


Open Quote 


DOl 

q 


Q 



D02 

W 


w 



DOS 

e 


E 



DO 4 

r 


R 



DO 5 

t 


T 



D06 

y 


Y 



D07 

U 


u 



DOS 

i 


I 



D09 

o 


0 



DIO 

p 


p 



Dll 

h 

Small a with ring (14/B) 

A 

Capital A with ring 

(12/B) 

1 D12 

It 

Quotation marks 

A 

Circumflex Char 


COl 

a 


A 



C02 

s 


s 



COS 

d 


D 



C04 

f 


F 



COB 

g 

. 

G 



C06 

h 


H 



C07 

j 


J 



COS 

k 


K 



C09 

1 


L 



CIO 

s 

Small ae dipthong (14/6) 

R 

Capital AE dipthong 

(12/6) 

Cll 

0 

Small o with slash (16/8) 

0 

Capital 0 with slash 

(13/8) 

C12 

f 

Apostrophe 

* 

Asterisk 


BOO 

< 

Less Than 

> 

Greater than 


BOl 

z 


Z 



B02 

X 


X 



BOS 

c 


c 



B04 

V 


V 



BOB 

b 


B 



B06 

n 


N 



B07 

m 


M 



BOS 

t 

Comma 

} 

Semicolon 


B09 


Period 

J 

Colon 


BIO 


Hyphen, Minus 


Underline 


emo 

TM 

Digital Internal Use Only 






el-00070-06 

VSRM - Keyboard Processing 


19-Apr-1988 


Page 6-94 


Danish Keyboard, 8-bit Characters, Data Processing Keys 
(Where different from 8-bit Characters, Typewriter keys) 

Position Unshifted Shifted 


EOO 


Tilde Char 

EOS 

3 



Dll 

} 

Closing 

brace 

CIO 

{ 

Opening 

brace 

Cll 

1 

Vertical 

bar 


@ Commercial at 
# Number sign 
] Closing bracket 
[ Opening bracket 
\ Back slash 


Danish Keyboard, 7-bit Characters, Typewriter Keys 
(Where different from 8-bit Characters, Typewriter keys) 

Position Unshifted Shifted 


EOO 

EOS 

Dll 

CIO 

Cll 


~ Tilde Char 
3 

k Small a with ring (7/13) 
s Small ae dipthong (7/11) 

0 Small o with slash (7/12) 


@ Commercial at 
# Numbe r sign 

A Capital A with ring (5/13) 
JE Capital AE dipthong (5/11) 
0 Capital 0 with slash (5/12) 


Danish Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 

Position Unshifted Shifted 


EOO 


Tilde 

Char 

EOS 

3 




Dll 

} 

Closi 

ng 

brace 

CIO 

{ 

Openi 

ng 

brace 

Cll 

1 

Verti 

cal 

bar 


@ Commercial at 
# Number sign 
] Closing bracket 
[ Opening bracket 
\ Back slash 


Erngosi' 
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6.14.7 

Danish Keyboard (1st, 

LK201-AD) 




8-bit 

Characters, Typewriter 

Keys 





Position Unshifted 



Shifted 


EOO 

[Tilde accent] 



0 

Degree sign (11/0) 


EOl 

1 



1 

• 

Exclamation mark 


E02 

2 



ft 

Quotation marks 


E03 

3 



§ 

Section sign (10/7) 


E04 

4 



$ 

Dollar sign 


E05 

5 



% 

Percent 


E06 

6 



& 

Ampersand 


E07 

7 



/ 

Slash 


E08 

8 



( 

Opening parenthesis 


E09 

9 



) 

Closing parenthesis 


ElO 

0 



« 

Equals 


Ell 

+ Plus 



? 

Question mark 


E12 

[Acute accent] 



[Grave accent] 


DOl 

q 



Q 



D02 

w 



W 



D03 

e 



E 



D04 

r 



R 



DOB 

t 



T 



D06 

y 



Y 



D07 

U 



U 



DOS 

i 



I 



D09 

o 



0 



DIO 

p 



p 



Dll 

k Small a with 

ring 

(14/5) 

A 

Capital A with ring 

(12/5) 

D12 

[ Dieresis ] 



[Circumflex accent] 


COl 

a 



A 



C02 

s 



S 



C03 

d 



D 



C04 

f 



F 



COB 

g 



G 



C06 

h 



H 



C07 

j 



j 



COS 

k 



K 



C09 

1 



L 



CIO 

X Small ae dipthong 

(14/6) 

E 

Capital AE dipthong 

(12/6) 

Cll 

0 Small o with 

slash 

(15/8) 

0 

Capital 0 with slash(13/8) 

C12 

' Apostrophe 



it 

Asterisk 


BOO 

< Less Than 



> 

Greater than 


BOl 

z 



z 



B02 

X 



X 



B03 

c 



c 



B04 

V 



V 



BOB 

b 



B 



B06 

n 



N 



B07 

m 



M 



BOS 

, Comma 



t 

Semicolon 


B09 

. Period 



: 

Colon 


BIO 

- Hyphen, Minus 



Underline 



EKir 
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Danish Keyboard, 8-bit Characters, Data Processing Keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position 


Unshifted 


Shifted 


E03 

Dll 

Cll 


3 

] Closing bracket 
# Number sign 


@ Commercial at 
( Opening bracket 
\ Back slash 


Danish Keyboard, 7-bit Characters, Typewriter Keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

E03 

E12 

Dll 

D12 

CIO 

Cll 


Dead 

3 

Dead 

h Small a with ring (7/13) 

[ Dieresis ] 

ae Small ae dipthong (7/11) 

0 Small o with slash (7/12) 


[Ring mark] 

Dead 

Dead 

A Capital A with ring (5/13) 
Dead 

E Capital AE dipthong (5/11) 

0 Capital 0 with slash (5/12) 


Danish Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

E03 

E12 

Dll 

D12 

CIO 

Cll 


Dead 

3 

Dead 

Dead 

[ Dieresis ] 

ae Small ae dipthong (7/11) 
# Number sign 


[Ring mark] 

Dead 

Dead 

Dead 

Dead 

^ Capital AE dipthong (5/11) 
Dead 


BDBDOSO 
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VSRM - 

Keyboard 

Processing 



6.14.8 

Finnish 

Keyboard (Srd, LK201-NX) 



8-bit 

Characters 

Typewriter Keys 



Position Unshifted 

Shifted 

EOO 

- 

Tilde Char 

@ 

Commercial at 

EOl 

1 


i 

Exclamation mark 

E02 

2 


N 

Quotation marks 

EOS 

S 


S 

Section sign (10/7) 

E04 

4 


$ 

Dollar sign 

EOS 

S 


% 

Percent sign 

E06 

6 


& 

Ampersand 

E07 

7 


/ 

Slash 

EOO 

8 


( 

Opening parenthesis 

E09 

9 


) 

Closing parenthesis 

ElO 

0 


= 

Equals 

Ell 

+ 

Plus 

? 

Question mark 

E12 


Circumflex Char 

t 

Open Quote 

DOl 

q 


Q 


D02 

W 


w 


DOS 

e 


E 


D04 

r 


R 


DOS 

t 


T 


D06 

y 


Y 


D07 

U 


u 


D08 

i 


I 


D09 

o 


0 


DIO 

p 


p 


Dll 

h 

Small a with ring (14/S) 

A 

Capital A with ring (12/S) 

D12 

ii 

small u w/umlaut (is/12) 

0 

Capital U w/umlaut (13/12) 

COl 

a 


A 


C02 

s 


s 


COS 

d 


D 


C04 

f 


F 


COS 

g 


G 


C06 

h 


H 


C07 

j 


J 


C08 

k 


K 


C09 

1 


L 


CIO 

-6 

small o with umlaut (lS/6) 

0 

Capital 0 w/umlaut (13/6) 

Cll 

a 

small a with umlaut (14/4) 

A 

Capital A w/umlaut (12/4) 

C12 

f 

Apostrophe 

★ 

Asterisk 

BOO 

< 

Less Than 

> 

Greater than 

BOl 

z 


Z 


B02 

X 


X 


BOS 

c 


c 


B04 

V 


V 


BOS 

b 


B 


B06 

n 


N 


B07 

m 


M 


B08 

9 

Comma 

9 

Semicolon 

B09 

• 

Period 


Colon 

BIO 

- 

Hyphen, Minus 


Underline 


mmr 
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Finish Keyboard, 8-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOS 

Dll 

D12 

CIO 

Cll 


3 

} Closing brace 
~ Tilde character 
I Vertical line 
{ Opening brace 


# Number sign 
] Closing bracket 
" Circumflex character 
\ Backslash 
t Opening bracket 


Finnish Keyboard, 7-bit Characters, Typewriter keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

EOS 

E12 

Dll 

D12 

CIO 

Cll 


Dead 

3 

Dead 

& Small a with ring (7/13) 
u small u with umlaut (7/14) 
o small o with umlaut (7/12) 
M small a with umlaut (7/11) 


@ Commercial at 
# Number Sign 
Dead 

A Capital A with ring (5/13) 
ij Capital U w/umlaut (5/14) 

6 Capital 0 w/umlaut (5/12) 
A Capital A w/umlaut (5/11) 


Finnish Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 

Position Unshifted Shifted 


E03 

Dll 

D12 

CIO 

Cll 


3 

} Closing brace 
Tilde character 
I vert bar 
{ Opening brace 


# Number sign 
) Closing bracket 
^ Circumflex character 
\ Back slash 
( Opening bracket 
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6.14.9 

Finnish 

Keyboard (2nd, LK201-NF) 



8-bit 

Characters 

1 , Typewriter Keys 



Position Unshifted 

Shifted 

EOO 

[Tilde mark] 

@ 

Commercial at 

EOl 

1 


1 

• 

Exclamation mark 

E02 

2 


tl 

Quotation marks 

EOS 

S 


§ 

Section sign (10/7) 

E04 

4 


$ 

Dollar sign 

EOS 

S 


% 

Percent sign 

E06 

6 


& 

Ampersand 

E07 

7 


/ 

Slash 

EOO 

8 


( 

Opening parenthesis 

E09 

9 


) 

Closing parenthesis 

ElO 

0 


= 

Equals 

Ell 

+ 

Plus 

? 

Question mark 

E12 

[Circumflex accent] 

[Grave accent] 

DOl 

q 


Q 


D02 

W 


W 


DOS 

e 


E 


D04 

r 


R 


DOS 

t 


T 


D06 

y 


y 


D07 

U 


u 


D08 

i 


I 


D09 

o 


0 


DIO 

p 


P 


Dll 

k 

Small a with ring (14/S) 

A 

Capital A with ring (12/S) 

D12 

u 

small u w/umlaut (lS/12) 

u 

Capital U w/umlaut (13/12) 

COl 

a 


A 


C02 

s 


s 


COS 

d 


D 


C04 

f 


F 


COS 

9 


G 


C06 

h 


H 


C07 

j 


j 


C08 

k 


K 


C09 

1 


L 


CIO 

6 

small o with umlaut (lS/6) 

6 

Capital 0 w/umlaut (13/6) 

Cll 

a 

small a with umlaut (14/4) 

A 

Capital A w/umlaut ^2/4) 

C12 

r 

Apostrophe 

★ 

Asterisk 

BOO 

< 

Less than 

> 

Greater than 

BOl 

Z 


z 


B02 

X 


X 


BOS 

c 


c 


B04 

V 


V 


BOS 

b 


B 


B06 

n 


N 


B07 

m 


M 


B08 

/ 

Comma 

f 

Semicolon 

B09 

• 

Period 

: 

Colon 

BIO 

- 

Hyphen, Minus 


Underline 


BSBD 


Digital Internal Use Only 



EL-00070-06 

VSRM - Keyboard Processing 


19-Apr-1988 


Page 6-100 


Finish Keyboard, 8-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position 


Unshifted 


Shifted 


EOS 3 

Dll } 

CIO I 

Cll { 


Closing brace 
Vertical line 
Opening brace 


# Number sign 
] Closing bracket 
\ Backslash 
[ Opening bracket 


Finnish Keyboard, 7-bit Characters, Typewriter keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

EOS 

E12 

Dll 

D12 

CIO 

Cll 


Dead 

3 

Dead 

h Small a with ring (7/13) 
ii small u with umlaut (7/14) 
6 small o with umlaut (7/12) 
S small a with umlaut (7/11) 


@ Commercial at 
# Number sign 
Dead 

A Capital A with ring (5/13) 
U Capital U w/umlaut (5/14) 

6 Capital 0 w/umlaut (5/12) 
A Capital A w/umlaut (5/11) 


Finnish Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

E03 

E12 

Dll 

D12 

CIO 

Cll 


~ Tilde 
3 

Circumflex 
} Closing brace 
Dead 

1 Vertical line 
{ Opening brace 


@ Commercial at 
# Number sign 
' Open Quote 
] Closing bracket 
Dead 

\ Backslash 
( Opening bracket 
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6.14.10 Finnish Keyboard (1st, LK201-AF) 
8-bit Characters, Typewriter Keys 


Position 

Unshifted 


Shifted 

EOO 

[Tilde mark] 


0 

Degree sign 

EOl 

1 



1 

Exclamation mark 

E02 

2 



II 

Quotation marks 

E03 

S 



§ 

Section sign (10/7) 

E04 

4 



$ 

Dollar sign 

EOS 

S 



% 

Percent sign 

E06 

6 



& 

Ampersand 

E07 

7 



/ 

Slash 

EOO 

8 



( 

Opening parenthesis 

E09 

9 



) 

Closing parenthesis 

ElO 

0 



s 

Equals 

Ell 

+ 

Plus 


? 

Question mark 

E12 

[Circumflex accent] 


[Grave accent] 

DOl 

q 



Q 


D02 

w 



w 


DOS 

e 



E 


D04 

r 



R 


DOS 

t 



T 


D06 

y 



Y 


D07 

U 



U 


D08 

i 



I 


D09 

o 



0 


DIO 

p 



p 


Dll 

k 

Small a with ring (14/S) 

A 

Capital A with ring (12/5) 

D12 

ii 

small u w/umlaut (15/12) 

u 

Capital U w/umlaut (lS/12) 

COl 

a 



A 


C02 

s 



s 


COS 

d 



D 


C04 

f 



F 


COS 

g 



G 


C06 

h 



H 


C07 

j 



J 


C08 

k 



K 


C09 

1 



L 


CIO 

6 

small o with umlaut 

(15/6) 

6 

Capital 0 w/umlaut (lS/6) 

Cll 

a 

small a with umlaut 

(14/4) 

A 

Capital A w/umlaut (12/4) 

C12 

f 

Apostrophe 


* 

Asterisk 

BOO 

< 

Less Than 


> 

Greater than 

BOl 

z 



Z 


B02 

X 



X 


BOS 

c 



c 


B04 

V 



V 


BOS 

b 



B 


B06 

n 



N 


B07 

m 



M 


BOO 

9 

Comma 


9 

Semicolon 

B09 


Period 


: 

Colon 

BIO 

- 

Hyphen, Minus 



Underline 
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Finish Keyboard, 8-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


E03 

Dll 

D12 


3 

] Closing bracket 
# Number sign 


@ Commercial at 
[ Opening bracket 
\ Backslash 


Finnish Keyboard, 7-bit Characters, Typewriter keys 
(Where different from 8-bit Characters, Typewriter keys) 

Position Unshifted Shifted 


EOO 

E03 

E12 

Dll 

D12 

CIO 

Cll 


Dead 

3 

Dead 

h Small a with ring (7/13) 
u small u with umlaut (7/14) 
6 small o with umlaut (7/12) 
a small a with umlaut (7/11) 


Dead 

Dead 

Dead 

A Capital A with ring (5/13) 
U Capital U w/umlaut (5/14) 

6 Capital 0 w/umlaut (5/12) 
A Capital A w/umlaut (5/11) 


Finnish Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

E03 

E12 

Dll 

D12 

CIO 

Cll 


Dead Dead 
3 Dead 
Dead Dead 
Dead Dead 
# Number sign Dead 


6 small o with umlaut (7/12) 0 Capital O w/umlaut (5/12) 
a small a with umlaut (7/11) A Capital A w/umlaut (5/11) 


BDam 
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6.14.11 

Austrian/German Keyboard 

(2nd, LK201-NG) 

8-bit Characters, Typewriter keys 




Position 

Unshi£ted 


Shifted 

EOO 

- 

Tilde char 


- 

Circumflex char 

EOl 

1 



1 

• 

Exclamation mark 

E02 

2 



II 

Quotation marks 

EOS 

3 



§ 

Section sign (10/7) 

E04 

4 



$ 

Dollar sign 

EOS 

S 



% 

Percent 

E06 

6 



& 

Ampersand 

E07 

7 



/ 

Slash 

EOO 

8 



( 

Opening parenthesis 

E09 

9 



) 

Closing parenthesis 

ElO 

0 



« 

Equals 

Ell 

8 

German small sharp s 

(13/lS) 

? 

Question mark 

E12 

f 

Apostrophe 



Open Quote 

DOl 

q 



Q 


D02 

W 



w 


D03 

e 



E 


D04 

r 



R 


DOS 

t 



T 


D06 

z 



Z 


D07 

u 



U 


DOS 

i 



I 


D09 

o 



0 


DIO 

p 



p 


Dll 

ii 

small u w/umlaut (lS/12) 

u 

Capital U w/umlaut (13/12) 

D12 

+ 

Plus 


* 

Asterisk 

COl 

a 



A 


C02 

s 



S 


COS 

d 



D 


C04 

f 



F 


COS 

g 



G 


C06 

h 



H 


C07 

j 



J 


COS 

k 



K 


C09 

1 



L 


CIO 

6 

small o with umlaut 

(15/6) 

6 

Capital 0 w/umlaut (13/6) 

Cll 

a 

small a with umlaut 

(14/4) 

A 

Capital A w/umlaut (12/4) 

C12 

# 

Number sign 


f 

Apostrophe 

BOO 

< 

Less Than 


> 

Greater than 

BOl 

y 



Y 


B02 

X 



X 


BOS 

c 



C 


B04 

V 



V 


BOS 

b 



B 


B06 

n 



N 


B07 

m 



M 


BOS 

t 

Comma 


f 

Semicolon 

B09 


Period 


: 

Colon 

Bio 

- 

Hyphen, Minus 



Underline 


mwBir 
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Austrian/German Keyboard, 8-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


Ell 

1 

Vertical bar 

Dll 


Commercial at 

CIO 

} 

Close Brace 

Cll 

1 

Closing bracket 


? Question mark 
\ Backslash 
{ Open brace 
[ Opening bracket 


Austrian/German Keyboard, 7-bit Characters, Typewriter keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

E03 

Ell 

Dll 

CIO 

Cll 


Dead 

3 

6 German small sharp s (7/14) 
ii small u with umlaut (7/13) 

3 small o with umlaut (7/12) 
a small a with umlaut (7/11) 


Circumflex Char 

5 Section sign (4/10) 

? Question mark 

ij Capital U w/umlaut (5/13) 

6 Capital 0 w/umlaut (5/12) 
A Capital A w/umlaut (5/11) 


Austrian/German Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


E03 

3 


Ell 

1 

Vertical bar 

Dll 


Commercial at 

CIO 

} 

Closing Brace 

Cll 

1 

Closing bracket 


Dead 

? Question mark 
\ Backslash 
{ Opening Brace 
[ Opening bracket 
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6.14.12 

Austrian/German Keyboard 

(1st, LK201 

.-AG) 

8-bit Characters, Typewriter keys 




Position 

Unshifted 


Shifted 

EOO 

[Tilde mark] 


[Circumflex accent] 

EOl 

1 


1 

Exclamation mark 

E02 

2 


tl 

Quotation marks 

E03 

3 


§ 

Section sign (10/7 

E04 

4 


$ 

Dollar sign 

E05 

5 


% 

Percent 

E06 

6 


& 

Ampersand 

E07 

7 


/ 

Slash 

E08 

8 


( 

Opening parenthesi: 

E09 

9 


) 

Closing parenthesi: 

ElO 

0 


* 

Equals 

Ell 

fi German small sharp s 

(13/15) 

? 

Question mark 

E12 

[Acute accent] 


[Grave accent] 

DOl 

q 


Q 


D02 

w 


w 


D03 

e 


E 


D04 

r 


R 


DOS 

t 


T 


D06 

z 


z 


D07 

u 


u 


D08 

i 


I 


D09 

o 


0 


DIO 

p 


p 


Dll 

ii small u w/umlaut (15/12) 

u 

Capital U w/umlaut 

D12 

+ Plus 


* 

Asterisk 

COl 

a 


A 


C02 

s 


s 


C03 

d 


D 


C04 

f 


F 


COB 

g 


G 


C06 

h 


H 


C07 

j 


J 


C08 

k 


K 


C09 

1 


L 


CIO 

6 small o with umlaut 

(15/6) 

6 

Capital 0 w/umlaut 

Cll 

ei small a with umlaut 

(14/4) 

A 

Capital A w/umlaut 

C12 

# Number sign 


f 

Apostrophe 

BOO 

< Less than 


> 

Greater than 

BOl 

y 


y 


B02 

X 


X 


B03 

c 


c 


B04 

V 


V 


B05 

b 


B 


B06 

n 


N 


B07 

m 


M 


BOO 

, Comma 


/ 

Semicolon 

B09 

. Period 


: 

Colon 

BIO 

- Hyphen, Minus 



Underline 


(13/12) 


(13/6) 

(12/4) 


SflSDDSD 
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Austrian/German Keyboard, 8-bit Characters, Data Processing keys 
(Vfhere different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


Dll @ Commercial at 

Cll ] Closing bracket 


\ Backslash 
I Opening bracket 


Austrian/German Keyboard, 7-bit Characters, Typewriter keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

E03 

Ell 

E12 

Dll 

CIO 

Cll 


Dead 

3 

B German small sharp s (7/14) 
Dead 

ii small u w/umlaut (7/13) 

6 small o with umlaut (7/12) 
a small a with umlaut (7/11) 


^ Circumflex char 

5 Section sign (4/10) 

? Question mark 

' Open quote 

U Capital U w/umlaut (5/13) 

6 Capital 0 w/umlaut (5/12) 
A Capital A w/umlaut (5/11) 


Austrian/German Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

E03 

Ell 

E12 

Dll 

CIO 

Cll 


Dead 

3 

B German small sharp s (7/14) 

Dead 

Dead 

6 small o with umlaut (7/12) 
Dead 


Circumflex char 
§ Section sign (4/10) 

? Question mark 
' Open quote 
Dead 

6 Capital O w/umlaut (5/12) 
Dead 


TM 
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6.14.13 Dutch Keyboard (2nd, LK201-NH) 

The Dutch keyboard is equivalent to the North American keyboard. 


TM 
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6.14.14 

Dutch Keyboard (1st, 

LK201-AH) 

8-bit Characters, Typewriter ] 

Keys 

Position 

Unshifted 

Shifted 

EOO 

[Tilde mark] 

“ Degree sign 

EOl 

1 

k one-qrtr 

E02 

2 

k one-half 

E03 

3 

£ British pound 

E04 

4 

$ Dollar sign 

E05 

B 

% Percent sign 

E06 

6 

# Number sign 

E07 

7 

& Ampersand 

E08 

8 

( Opening parenthesis 

E09 

9 

( Closing parenthesis 

ElO 

0 

§ Section sign 

Ell 

' Apostrophe 

" Quotation marks 

E12 

/ Slash 

: Colon 

DOl 

q 

Q 

D02 

w 

w 

D03 

e 

E 

D04 

r 

R 

DOB 

t 

T 

D06 

y 

Y 

D07 

U 

u 

D08 

i 

I 

D09 

o 

0 

DIO 

p 

p 

Dll 

[Circumflex accent] [Dieresis] 

D12 

* Asterisk 

! Exclamation mark 

COl 

a 

A 

C02 

s 

s 

C03 

d 

D 

C04 

f 

F 

COB 

g 

G 

C06 

h 

H 

C07 

j 

J 

C08 

k 

K 

C09 

1 

L 

CIO 

- Hyphen, Minus 

Underline 

Cll 

[Grave accent] 

[Acute accent] 

C12 

@ Commercial at 

1 Vertical line 

BOO 

< Less Than 

> Greater than 

BOl 

z 

Z 

B02 

X 

X 

B03 

c 

c 

B04 

V 

V 

BOB 

b 

B 

B06 

n 

N 

B07 

m 

M 

B08 

, Comma 

? Question mark 

B09 

. Period 

; semicolon 

BlO 

+ Plus 

= Equals 
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Dutch Keyboard, 8-bit Characters, Data Processing Keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


E02 2 

E03 3 

ElO 0 


[ Opening bracket 
] Closing bracket 
\ Backslash 


Dutch Keyboard, 7-bit Characters, Typewriter Keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

EOl 

E02 

B03 

E06 

ElO 

Dll 

Cll 

C12 


Dead 

1 

2 

3 

6 

0 

^ Circumflex Character 


' Open quote 
Dead 


Dead 

h one-qrtr (7/13) 

Js one-half (5/12) 

£ British pound (2/3) 

Dead 

Dead 

" Dieresis 
' Apostrophe 
1 Vertical line 


Dutch Keyboard, 7-bit Characters, Data Processing Keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

EOl 

E02 

E03 

E06 

ElO 

Cll 

C12 


Dead 

1 

2 

3 

6 

0 

' Open quote 
Dead 


Dead 

H one-qrtr (7/13) 

Dead 

Dead 

Dead 

Dead 

' Apostrophe 
I Vertical line 


mr 
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6.14.15' Italian Keyboard (LK201-AI) 

8-bit Characters, Typewriter keys 

Position Unshifted 

Shifted 

EOO 

[Grave accent] 

[Tilde mark] 

EOl 

£ British pound sign (10/S) 

1 


E02 

e Small e with acute (14/9) 

2 


EOS 

" Quotation marks 

S 


E04 

' Apostrophe 

4 


EOS 

( Opening parenthesis 

5 


E06 

Underline 

6 


E07 

e small e with grave (14/8) 

7 


EOO 

[Circumflex accent] 

8 


E09 

9 Small c with Cedilla (14/7) 

9 


ElO 

a Small a with grave (14/0) 

0 


Ell 

) Closing parenthesis 

O 

Degree sign (11/0) 

E12 

- Hyphen, Minus 

+ 

Plus 

DOl 

q 

Q 


D02 

Z 

Z 


DOS 

e 

E 


D04 

r 

R 


DOS 

t 

T 


D06 

y 

Y 


D07 

U 

u 


DOS 

i 

I 


D09 

o 

0 


DIO 

p 

p 


Dll 

i Small i with grave (14/12) 

= 

Equals 

D12 

$ Dollar sign 

& 

Ampersand 

COl 

a 

A 


C02 

s 

S 


COS 

d 

D 


C04 

f 

F 


COS . 

g 

G 


C06 

h 

H 


C07 

j 

J 


COS 

k 

K 


C09 

1 

L 


CIO 

m 

M 


Cll 

u Small u with grave (15/19) 

% 

Percent sign 

C12 

* Asterisk 

§ 

Section sign (10/7) 

BOO 

< Less Than 

> 

Greater than 

BOl 

w 

W 


B02 

X 

X 


BOS 

c 

c 


B04 

V 

V 


BOS 

b 

B 


B06 

n 

N 


BO 7 

, Comma 

7 

Question mark 

BOS 

; Semicolon 


Period 

B09 

: Colon 

/ 

Slash 

BIO 

6 Small o with grave (15/2) 

1 

Exclamation point 


SgSDSID 
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Italian Keyboard, 8-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOl 

E02 

E09 

ElO 

C12 


@ Commercial at 

# Number sign 

[ Opening bracket 
] Closing bracket 

* Asterisk 


1 

2 

9 

0 

\ Backslash 


Italian Keyboard, 7-bit Characters, Typewriter keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

EOl 

E02 

E07 

E09 

ElO 

Ell 

Dll 

Cll 

C12 

B09 

BIO 


[Grave accent] 

£ British pound sign (2/3) 
e Small e with acute (5/13) 
e small e with grave (7/13) 

5 Small c w/Cedilla (5/12) 
a Small a with grave (7/11) 
) Closing parenthesis 

i Small i with grave (7/14) 
u Small u with grave (6/0) 

* Asterisk 
; Colon 

6 Small o with grave (7/12) 


Dead 

1 

2 

7 

9 

0 

" Degree sign (5/11) 
» Equals 
% Percent sign 
S Section sign (4/0) 
/ Slash 

I Exclamation point 


Italian Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

EOl 

E02 

E07 

E08 

E09 

ElO 

Ell 

Dll 

Cll 

C12 

B09 

BIO 


' Open Quote 
@ Commercial at 

# Number sign 
Dead 

^ Circumflex Character 
[ Opening bracket 
] Closing bracket 
) Closing parenthesis 
Dead 
Dead 

* Asterisk 
: Colon 
Dead 


Tilde Char 

1 

2 

7 

8 
9 
0 

Dead 

= Equals 
% Percent sign 
\ Backslash 
/ Slash 

! Exclamation point 


SDllOaD 
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6.14.16 

Swiss (French) Keyboard (LK201-AK) 

8-bit Characters, Typewriter keys 

Position Onshifted 


Shifted 

EOO 

! Exclamation mark 


® Degree sign (11/0) 

EOl 

1 


+ Plus 

E02 

2 


" Quotation marks 

E03 

3 


* Asterisk 

E04 

4 


5 Small c w/Cedilla (14/7) 

E05 

B 


% Percent sign 

E06 

6 


& Ampersand 

E07 

7 


/ Slash 

E08 

8 


( Opening parenthesis 

E09 

9 


) Closing parenthesis 

ElO 

0 


= Equals 

Ell 

' Apostrophe 


? Question mark 

E12 

[Circumflex accent] 


(Grave accent] 

DOl 

q 


Q 

D02 

w 


W 

D03 

e 


E 

D04 

r 


R 

DOB 

t 


T 

D06 

z 


Z 

D07 

u 


u 

D08 

i 


I 

D09 

0 


0 

DIO 

p 


p 

Dll 

e small e with grave 

(14/8) 

u small u w/umlaut (lB/12) 

D12 

[Dieresis] 


[Tilde mark] 

COl 

a 


A 

C02 

s 


S 

C03 

d 


D 

C04 

f 


F 

COB 

g 


G 

C06 

h 


H 

C07 

j 


J 

C08 

k 


K 

C09 

1 


L 

CIO 

e Small e with acute 

(14/9) 

6 small o w/umlaut (15/6) 

Cll 

a Small a with grave 

(14/0) 

a small a w/umlaut (14/4) 

C12 

$ Dollar sign 


£ U.K. Pound (10/3) 

BOO 

< Less Than 


> Greater than 

BOl 

y 


Y 

B02 

X 


X 

B03 

c 


C 

B04 

V 


V 

BOB 

b 


B 

B06 

n 


N 

B07 

m 


M 

B08 

, Comma 


; Semicolon 

B09 

. Period 


: Colon 

BlO 

- Hyphen, Minus 


_ Underline 

mmr 
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Swiss (French) Keyboard, 8-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


E04 

Dll 

CIO 

Cll 

C12 


4 

e small e with grave (14/8) 
e Small e with acute (14/9) 
a Small a with grave (14/0) 
$ Dollar sign 


@ Commercial at 
\ Backslash 
[ Opening bracket 
] Closing bracket 
# Number sign 


Swiss (French) Keyboard, 7-bit Characters, Typewriter keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position 

Unshifted 


EOO 

! Exclamation mark 

E04 

4 


Dll 

e small e with 

grave 

D12 

[Dieresis] 


CIO 

e Small e with 

acute 

Cll 

a Small a with 

grave 

C12 

$ Dollar sign 


BIO 

- Hyphen, Minus 


Shifted 


Dead 

9 Small c w/Cedilla (5/12) 
(5/15) u small u with umlaut (7/13) 
Dead 

(5/11) 6 small o w/umlaut (7/12) 
(4/0) a small a w/umlaut (7/11) 

Dead 
Dead 


Swiss (French) Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position 


Unshifted 


Shifted 


EOO 

E04 

E12 

Dll 

D12 

CIO 

Cll 

C12 


! Exclamation mark 
4 

Circumflex Char 
Dead 

" Quotation marks 

Dead 

Dead 

$ Dollar sign 


Dead 

@ Commercial at 
'Open Quote 
\ Backslash 
~ Tilde Char 
[ Opening bracket 
] Closing bracket 
# Number sign 


mm 
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VSRM - Keyboard Processing 

6.14.17 Swiss (German) Keyboard (LK201-AL) 

8-bit Characters, Typewriter keys 

Page 6-114 

Position 

Unshifted 

Shifted 

BOO 

! Exclamation mark 

" Degree sign (11/0) 

EOl 

1 

+ Plus 

E02 

2 

" Quotation marks 

E03 

3 

* Asterisk 

E04 

4 

9 Small c w/Cedilla (14/7) 

EOS 

S 

% Percent 

E06 

6 

& Ampersand 

E07 

7 

/ Slash 

E08 

8 

( Opening parenthesis 

E09 

9 

) Closing parenthesis 

ElO 

0 

= Equals 

Ell 

' Apostrophe 

? Question mark 

E12 

[Circumflex accent] 

[Grave accent] 

DOl 

q 

Q 

D02 

W 

w 

003 

e 

E 

D04 

r 

R 

DOS 

t 

T 

006 

z 

z 

007 

u 

u 

D08 

i 

I 

009 

o 

0 

DIO 

p 

p 

Dll 

ii small u w/umlaut (lS/12) 

e small e with grave (14/8) 

012 

[ Dieresis 1 

[Tilde mark] 

COl 

a 

A 

C02 

s 

S 

C03 

d 

D 

C04 

f 

F 

COS 

g 

G 

C06 

h 

H 

C07 

j 

J 

C08 

k 

K 

C09 

1 

L 

CIO 

o small o with umlaut (lS/6) 

e Small e with acute (14/9) 

Cll 

a small a with umlaut (14/4) 

a Small a with grave (14/0) 

C12 

$ Dollar sign 

£ British pound sign (10/3) 

BOO 

< Less Than 

> Greater than 

BOl 

y 

Y 

B02 

X 

X 

B03 

c 

C 

B04 

V 

V 

BOS 

b 

B 

BOS 

n 

N 

B07 

m 

M 

BOS 

, Comma 

; Semicolon 

B09 

. Period 

: Colon 

BIO 

BDmiSi]' 

- Hyphen, Minus 

Digital Internal Use Only 
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Swiss (German) Keyboard, 8-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position 


Unshifted 


Shifted 


E04 

Dll 

CIO 

Cll 

C12 


4 

u small u w/umlaut (15/12) 

6 small o with umlaut (15/6) 
§ small a with umlaut (14/4) 
$ Dollar sign 


@ Commercial at 
\ Backslash 
[ Opening bracket 
] Closing bracket 
# Number sign 


Swiss (German) Keyboard, 7-bit Characters, Typewriter keys 
(Where different from 8-bit Characters, Typewriter keys) 

Position Unshifted Shifted 


EOO 

E04 

Dll 

D12 

CIO 

Cll 

C12 

BIO 


! Exclamation mark 
4 

u small u with umlaut 
[ Dieresis ] 

o small o with umlaut 
a small a with umlaut 
$ Dollar sign 
- Hyphen, Minus 


Dead 
9 Small 
(7/13) e small 
Dead 

(7/12) e Small 
(7/11) a Small 
Dead 
Dead 


c w/Cedilla (5/12) 
e with grave (5/15) 

e with acute (5/11) 
a with grave (4/0) 


Swiss (German) Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

E04 

E12 

Dll 

D12 

CIO 

Cll 

C12 


1 Exclamation mark 
4 

Circumflex Char 
Dead 

" Quotation marks 

Dead 

Dead 

$ Dollar sign 


Dead 

@ Commercial at 
' Open Quote 
\ Backslash 
Tilde Char 
[ Opening bracket 
) Closing bracket 
# Number sign 


BDSDOEID 


Digital Internal Use Only 



EL-00070-06 

VSRM - Keyboard Processing 


19-Apr-1988 


Page 6-116 


6.14.18 

Swedish 

i Keyboard (2nd, LK201-NM) 



8-bit Characters 

Typewriter keys 




Position 

Unshifted 


Shifted 

EOO 

- 

Tilde Char 


0 

Degree sign (11/0) 

EOl 

1 



f 

# 

Exclamation mark 

E02 

2 



tl 

Quotation marks 

EOS 

S 



§ 

Section sign (10/7) 

E04 

4 



$ 

Dollar sign 

E05 

B 



% 

Percent 

E06 

6 



& 

Ampersand 

E07 

7 



/ 

Slash 

E08 

8 



( 

Opening parenthesis 

E09 

9 



) 

Closing parenthesis 

ElO 

0 



= 

Equals 

Ell 

+ 

Plus 


? 

Question mark 

E12 


Circumflex Char 


\ 

Open Quote 

DOl 

q 



Q 


D02 

W 



w 


DOS 

e 



E 


D04 

r 



R 


DOB 

t 



T 


D06 

y 



Y 


D07 

U 



U 


D08 

i 



I 


D09 

o 



0 


DIO 

p 



p 


Dll 

k 

Small a with ring (14/lB) 

A 

Capital A with ring (12/B) 

D12 

ii 

small u with umlaut 

(15/12) 

0 

Capital U w/Umlaut (13/12) 

COl 

a 



A 


C02 

s 



S 


COS 

d 



D 


C04 

f 



F 


COB 

g 



G 


C06 

h 



H 


C07 

j 



J 


C08 

k 



K 


C09 

1 



L 


CIO 

6 

small o with umlaut 

(15/6) 

0 

Capital 0 w/umlaut (13/6) 

Cll 

a 

small a with umlaut 

(14/4) 

A 

Capital A w/umlaut (12/4) 

C12 

r 

Apostrophe 


it 

Asterisk 

BOO 

< 

Less Than 


> 

Greater than 

BOl 

Z 



z 


B02 

X 



X 


BOS 

c 



c 


B04 

V 



V 


BOB 

b 



B 


B06 

n 



N 


B07 

m 



M 


B08 

9 

Comma 


f 

Semicolon 

B09 

• 

Period 


: 

Colon 

BIO 

- 

Hyphen, Minus 



Underline 
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Swedish Keyboard, 8-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


E03 3 

Dll ] 

D12 # 

CIO } 


Closing bracket 
Number sign 
Close brace 
Vertical line 


@ Commercial at 
[ Opening bracket 
\ Backslash 
{ Open brace 
I Vertical line 


Swedish Keyboard, 7-bit Characters, Typewriter keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

E03 

E12 

Dll 

D12 

CIO 

Cll 


Dead 

3 

Dead 

h Small a with ring (7/13) 
ii small u with umlaut (7/14) 
6 small o with umlaut (7/12) 
a small a with umlaut (7/11) 


Dead 

Dead 

Dead 

A Capital A with ring (5/13) 
U Capital U w/Umlaut (5/14) 

6 Capital 0 w/umlaut (5/12) 
A Capital A w/umlaut (5/11) 


Swedish Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

*** 

Tilde Char 

E03 

3 


Dll 

] 

Closing bracket 

D12 

# 

Number sign 

CIO 

} 

Close Brace 

Cll 

1 

Vertical line 


Dead 

@ Commercial at 
( Opening bracket 
\ Backslash 
{ Open Brace 
I Vertical line 


mmm 


TM 
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VSRM - Keyboard 

Processing 



6.14.19 

Swedish 

. Keyboard (1st, LK201-AM) 



8-bit Characters 

, Typewriter keys 



Position 


Unshifted 

Shifted 

EOO 


[Tilde mark] 

0 

Degree sign (11/0) 

EOl 


1 


1 

• 

Exclamation mark 

E02 


2 


If 

Quotation marks 

E03 


3 


s 

Section sign (10/7) 

E04 


4 


$ 

Dollar sign 

E05 


B 


% 

Percent 

E06 


6 


& 

Ampersand 

E07 


7 


/ 

Slash 

E08 


8 


( 

Opening parenthesis 

E09 


9 


) 

Closing parenthesis 

ElO 


0 


* 

Equals 

Ell 


+ 

Plus 

? 

Question mark 

E12 


[Circumflex accent] 

[drave accent] 

DOl 


q 


Q 


D02 


w 


w 


D03 


e 


E 


D04 


r 


R 


DOB 


t 


T 


D06 


y 


Y 


D07 


U 


U 


D08 


i 


I 


D09 


o 


0 


DIO 


p 


P 


Dll 


k 

Small a with ring (14/lB) 

A 

Capital A with ring (12/B) 

D12 


ii 

small u with umlaut (lB/12) 

ii 

Capital U w/Umlaut (13/12) 

COl 


a 


A 


C02 


s 


s 


C03 


d 


D 


C04 


f 


F 


COB 


g 


G 


C06 


h 


H 


C07 


j 


j 


COO 


k 


K 


C09 


1 


L 


CIO 


6 

small o with umlaut (lB/6) 

6 

Capital 0 w/umlaut (13/6) 

Cll 


k 

small a with umlaut (14/4) 

A 

Capital A w/umlaut (12/4) 

C12 


f 

Apostrophe 

* 

Asterisk 

BOO 


< 

Less Than 

> 

Greater than 

BOl 


z 


z 


B02 


X 


X 


B03 


c 


c 


B04 


V 


V 


BOB 


b 


B 


B06 


n 


N 


B07 


m 


M 


BOO 


9 

Comma 

f 

Semicolon 

B09 



Period 

: 

Colon 

BIO 



Hyphen, Minus 


Underline 

raosiD' 
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Swedish Keyboard, 8-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position 


Unshifted 


Shifted 


EOS 

Dll 

D12 


3 

] Closing bracket 
# Number sign 


@ Commercial at 
[ Opening bracket 
\ Backslash 


Swedish Keyboard, 7-bit Characters, Typewriter keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

EOS 

E12 

Dll 

D12 

CIO 

Cll 


Dead 

3 

Dead 

& Small a with ring (7/13) 
ii small u with umlaut (7/14) 
6 small o with umlaut (7/12) 
a small a with umlaut (7/11) 


Dead 

Dead 

Dead 

A Capital A with ring (5/13) 
U Capital U w/umlaut (5/14) 

6 Capital O w/umlaut (5/12) 
A Capital A w/umlaut (5/11) 


Swedish Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

EOS 

E12 

Dll 

D12 

CIO 

Cll 


Dead Dead 
3 Dead 
Dead Dead 
Dead Dead 
# Number sign Dead 


6 small o with umlaut (7/12) 6 Capital 0 w/umlaut (5/12) 
a small a with umlaut (7/11) A Capital A w/umlaut (5/11) 


TM 
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6.14.20 

Norwegian Keyboard 

(2nd, 

LK201-EN) 


8-bit Characters 

Typewriter 

keys 




Position 

Unshifted 



Shifted 

BOO 

- 

Tilde Char 



@ 

Commercial at 

EOl 

1 




! 

Exclamation mark 

E02 

2 




II 

Quotation marks 

E03 

3 




# 

Number sign 

E04 

4 




$ 

Dollar sign 

E05 

S 




% 

Percent 

E06 

6 




& 

Ampersand 

E07 

7 




/ 

Slash 

E08 

8 




( 

Opening parenthesis 

E09 

9 




) 

Closing parenthesis 

ElO 

0 




ss 

Equals 

Ell 

+ 

Plus 



7 

Question mark 

E12 

f 

Apostrophe 




Open quote 

DOl 

q 




Q 


D02 

W 




W 


D03 

e 




E 


D04 

r 




R 


DOS 

t 




T 


D06 

y 




Y 


D07 

U 




U 


D08 

i 




I 


D09 

o 




0 


DIO 

p 




p 


Dll 

h 

Small a with 

ring 

(14/S) 

A 

Capital A w/ring (12/S) 

D12 

tl 

Quotation marks 



Circumflex Character 

COl 

a 




A 


C02 

s 




S 


C03 

d 




D 


C04 

f 




F 


COS 

g 




G 


C06 

h 




H 


C07 

j 




J 


C08 

k 




K 


C09 

1 




L 


CIO 

0. 

Small o with 

slash 

(15/8) 

0 

Capital 0 w/slash (13/8) 

Cll 

® 

Small ae dipthong 

(14/6) 

E 

Capital AE dipthong( 12/6 ) 

C12 

r 

Apostrophe 



* 

Asterisk 

BOO 

< 

Less Than 



> 

Greater than 

BOl 

Z 




Z 


B02 

X 




X 


B03 

c 




c 


B04 

V 




V 


BOS 

b 




B 


BOS 

n 




N 


B07 

m 




M 


B08 

f 

Comma 



r 

Semicolon 

B09 

• 

Period 




Colon 

BIO 

- 

Hyphen, Minus 



Underline 


BDB 
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Norwegian Keyboard, 8-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 

Position Unshifted Shifted 


Dll 

} Closing brace 

CIO 

1 Vertical bar 

Cll 

{ Opening brace 


] Closing bracket 
\ Backslash 
[ Opening bracket 


Norwegian Keyboard, 7-bit Characters, Typewriter keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


Dll 

h 

Small a 

with ring 

CIO 

0 

Small o 

with slash 

Cll 

s 

Small ae dipthong 

BOS 

f 

Comma 


B09 

• 

Period 


BIO 

- 

Hyphen, 

Minus 


(7/13) A Capital A w/ring (5/13) 
(7/12) 0 Capital 0 w/slash (5/12) 

(7/11) R Capital AE dipthong (5/11) 
; Semicolon 
: Colon 
Underline 


Norwegian Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


Dll 

} Closing brace 

CIO 

1 Vertical bar 

Cll 

{ Opening brace 


] Closing bracket 
\ Backslash 
[ Opening bracket 


BBSSOESr 
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6.14.21 

Norwegian Keyboard 

(1st, 

LK201-AN) 

8-bit Characters, Typewriter 

keys 



Position 

Unshifted 



Shifted 

EOO 

[ Tilde mark ] 



® Degree sign 

EOl 

1 



1 Exclamation mark 

E02 

2 



" Quotation marks 

EOS 

S 



S Section sign 

E04 

4 



$ Dollar sign 

EOS 

S 



% Percent 

E06 

6 



& Ampersand 

E07 

7 



/ Slash 

EOO 

8 



( Opening parenthesis 

E09 

9 



) Closing parenthesis 

ElO 

0 



= Equals 

Ell 

+ Plus 



? Question mark 

E12 

[Acute accent] 



(Grave accent] 

DOl 

q 



Q 

D02 

w 



W 

DOS 

e 



E 

D04 

r 



R 

DOS 

t 



T 

D06 

y 



Y 

D07 

U 



U 

D08 

i 



I 

D09 

o 



0 

DIO 

p 



P 

Dll 

& Small a with 

ring 

(14/S) 

A Capital A w/ring (12/S) 

D12 

[Dieresis] 



[Circumflex accent] 

COl 

a 



A 

C02 

s 



S 

COS 

d 



D 

C04 

f 



P 

COS 

g 



G 

C06 

h 



H 

C07 

j 



J 

C08 

k 



K 

C09 

1 



L 

CIO 

0 Small o with 

slash 

(15/8) 

0 Capital 0 w/slash (13/8) 

Cll 

s Small ae dipthong 

(14/6) 

E Capital AE dipthong( 12/6 ; 

C12 

' Apostrophe 



* Asterisk 

BOO 

< Less Than 



> Greater than 

BOl 

z 



Z 

B02 

X 



X 

BOS 

c 



C 

B04 

V 



V 

BOS 

b 



B 

B06 

n 



N 

B07 

m 



M 

B08 

, Comma 



; Semicolon 

B09 

. Period 



: Colon 

BIO 

- Hyphen, Minus 


_ Underline 


mmm 
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Norwegian Keyboard, 8-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position 


Unshifted 


Shifted 


EOS 

Dll 

Cll 


3 

] Closing bracket 
# Number sign 


@ Commercial at 
[ Opening bracket 
\ Backslash 


Norwegian Keyboard, 7-bit Characters, Typewriter keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

EOS 

E12 

Dll 

D12 

CIO 

Cll 


Dead 

3 

Dead 

& Small a with ring (7/13) 
[Dieresis] 

0 Small o with slash (7/12) 
s Small ae dipthong (7/11) 


[Ring mark] 

Dead 

Dead 

A Capital A w/ring (5/13) 
Dead 

0 Capital O w/slash (5/12) 
E Capital AE dipthong ( 5/11 ) 


Norwegian Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

E03 

E12 

Dll 

D12 

CIO 

Cll 


Dead 

3 

Dead 

Dead 

[ Dieresis ] 

0 Small o with slash (7/12) 
# Number sign 


[Ring mark] 

Dead 

Dead 

Dead 

Dead 

0 Capital O w/slash (5/12) 
Dead 


am 
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VSRM - Keyboard Processing 


6.14.22 

Belgian/French Keyboard (LK201-AP) 


8-bit Characters, Typewriter keys 


Position 


Unshifted 

Shifted 

EOO 


(Grave accent] 

[Tilde mark] 

EOl 


& Ampersand 

1 

E02 


e Small e with acute (14/9) 

2 

E03 


" Quotation marks 

3 

E04 


' Apostrophe 

4 

E05 


( Opening parenthesis 

5 

E06 


S Section sign (10/7) 

6 

E07 


e small e with grave (14/8) 

7 

EOS 


1 Exclamation point 

8 

E09 


q Small c w/Cedilla (14/7) 

9 

ElO 


a Small a with grave (14/0) 

0 

Ell 


) Closing parenthesis 

° Degree sign (11/0) 

E12 


- Hyphen, Minus 

Underline 

DOl 


a 

A 

D02 


z 

Z 

D03 


e 

E 

D04 


r 

R 

DOS 


t 

T 

D06 


y 

Y 

D07 


U 

u 

DOS 


i 

I 

D09 


o 

0 

DIO 


p 

p 

Dll 


[Circumflex accent] 

[Dieresis] 

D12 


$ Dollar sign 

* Asterisk 

COl 


q 

Q 

C02 


S 

S 

C03 


d 

D 

C04 


f 

F 

COS 


g 

G 

C06 


h 

H 

C07 


j 

J 

COS 


k 

K 

C09 


1 

L 

CIO 


m 

M 

Cll 


u Small u with grave (lS/9) 

% Percent sign 

C12 


# Number sign 

@ Commercial at sign 

BOO 


< Less Than 

> Greater than 

BOl 


w 

W 

B02 


X 

X 

B03 


c 

c 

B04 


V 

V 

BOS 


b 

B 

B06 


n 

N 

B07 


, Comma 

? Question mark 

BOS 


; Semicolon 

. Period 

B09 


: Colon 

/ Slash 

BIO 

EigmiBil-' 


= Equals 
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Belgian/French Keyboard, 8-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position 


Unshifted 


Shifted 


E06 

[ 

Opening bracket 

E07 

1 

Closing bracket 

Cll 

\ 

Backslash 


6 

7 

% Percent sign 


Belgian/French Keyboard, 7-bit Characters, Typewriter keys 
(Where different from 8-bit Characters, Typewriter keys) 

Position Unshifted Shifted 


EOO 

E02 

E06 

E07 

E09 

ElO 

Ell 

Cll 

C12 


[Grave accent] 
e Small e with acute (7/11) 
S Section sign (5/13) 
e small e with grave (7/13) 
5 Small c w/Cedilla (5/12) 
a Small a with grave (4/0) 

) Closing parenthesis 
u Small u with grave (7/12) 
Dead 


Dead 

2 

6 

7 

9 

0 


“ Degree sign (5/11) 
% Percent sign 
Dead 


Belgian/French Keyboard, 7-bit Characters, Data Processing keys 
(where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

E02 

E06 

E07 

E09 

ElO 

Ell 

Dll 

Cll 


' Open Quote 
Dead 

[ Opening bracket 
1 Closing bracket 
Dead 
Dead 

) Closing parenthesis 
Circumflex Char 
\ Backslash 


Tilde Char 

2 

6 

7 

9 

0 

Dead 

" Quotation marks 
% Percent sign 
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VSRM - Keyboard Processing 


6.14.23 

Spanish Keyboard (LK201-AS) 


8-bit Characters, Typewriter keys 


Position 


Unshifted 

Shifted 

EOO 


1 Inverted Question (11/lB) 

I Inverted exclamation (10/1) 

EOl 


1 

1 Exclamation point 

E02 


2 

" Quotation marks 

E03 


3 

# Number sign 

E04 


4 

$ Dollar sign 

E05 


B 

% Percent sign 

E06 


6 

& Ampersand 

E07 


7 

/ Slash 

E08 


8 

( Opening parenthesis 

E09 


9 

) closing parenthesis 

ElO 


0 

»» Equals 

Ell 


' Apostrophe 

? Question mark 

E12 


2 Masc. ordinal ind (11/10) 

2 Fern, ordinal ind (10/10) 

DOl 


q 

Q 

D02 


w 

W 

D03 


e 

E 

D04 


r 

R 

D05 


t 

T 

D06 


y 

Y 

D07 


U 

U 

D08 


i 

I 

D09 


o 

0 

DIO 


p 

p 

Dll 


[Grave accent] 

[Circumflex accent] 

D12 


+ Plus 

* Asterisk 

COl 


a 

A 

C02 


s 

S 

C03 


d 

D 

C04 


f 

F 

COB 


g 

G 

C06 


h 

H 

C07 


j 

J 

C08 


k 

K 

C09 


1 

L 

CIO 


n Small n with Tilde (lB/1) 

N Capital N w/Tilde (13/1) 

Cll 


[Acute accent] 

[Dieresis] 

C12 


9 Small c w/Cedilla (14/7) 

[Tilde mark] 

BOO 


< Less Than 

> Greater than 

BOl 


z 

Z 

B02 


X 

X 

B03 


c 

c 

B04 


V 

V 

BOB 


b 

B 

B06 


n 

N 

B07 


m 

M 

B08 


, Comma 

; Semicolon 

BO 9 


. Period 

: Colon 

BIO 

BBSSBEID' 


- Hyphen, Minus 
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Spanish Keyboard, 8-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 

Position Unshifted Shifted 


EOO 

E12 


@ Commercial at \ Backslash 

] Closing bracket [ Opening bracket 


Spanish Keyboard, 7-bit Characters, Typewriter keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position Unshifted 


Shifted 


EOO 

EOS 

E12 

CIO 

C12 


i Inverted Question (5/13) 
3 

Dead 

n Small n w/Tilde (7/12) 

5 Small c w/Cedilla (7/13) 


5 Inverted exclamation (5/11) 

Dead 

Dead 

N Capital N w/Tilde (5/12) 
[Tilde mark] 


Spanish Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position 


Unshifted 


Shifted 


EOO 

E12 

Dll 

CIO 

Cll 

C12 


@ Commercial at 
] Closing bracket 
' Open quote 
Dead 

' Apostrophe 
Dead 


\ Backslash 
[ Opening bracket 

Circumflex character 
Dead 

" Quotation marks 
Tilde character 
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1 

1 

1 

1 

6.14.24 Portuguese Keyboard (LK201-AV) 

8-bit Characters, Typewriter keys 


1 

1 

1 

Position 

Unshifted 


Shifted 

1 

1 

EOO 

\ Backslash 


1 Vertical line 

1 

EOl 

1 


! Exclamation point 

1 

E02 

2 


@ Commercial at 

1 

E03 

3 


# Number sign 

1 

E04 

4 


$ Dollar sign 

1 

EOS 

S 


% Percent sign 


E06 

6 


” Quotations 

1 

E07 

7 


& Ampersand 

1 

E08 

8 


* Asterisk 

1 

E09 

9 


( Opening parenthesis 

1 

ElO 

0 


) Closing parenthesis 

1 

Ell 

- Hyphen, Minus 


Underline 

1 

El 2 

- Equals 


+ Plus 

1 

DOl 

q 


Q 

1 

D02 

w 


w 

1 

D03 

e 


E 

1 

D04 

r 


R 

1 

DOS 

t 


T 

1 

D06 

y 


Y 

1 

D07 

U 


U 

1 

D08 

1 


I 

1 

D09 

O 


0 

1 

DIO 

p 


p 

1 

Dll 

[Acute accent] 


[Grave accent] 

1 

D12 

] Closing bracket 


} Closing brace 

1 

COl 

a 


A 

1 

C02 

s 


S 

1 

C03 

d 


D 

1 

C04 

f 


F 

1 

COS 

g 


G 

1 

C06 

h 


H 

1 

C07 

j 


J 

1 

C08 

k 


K 

1 

C09 

1 


L 

1 

CIO 

g Small c w/cedilla 

(14/7) 

Q Capital C w/cedilla (12/7) 

1 

Cll 

[Tilde mark] 


[Circumflex accent] 

1 

C12 

( Opening bracket 


[ Opening brace 

1 

BOO 

< Less Than 


> Greater than 

1 

BOl 

z 


z 

1 

B02 

X 


X 

1 

B03 

c 


C 

1 

B04 

V 


V 

1 

BOS 

b 


B 

1 

B06 

n 


N 

1 

B07 

m 


M 

1 

B08 

, Comma 


; Semicolon 

1 

B09 

. Period 


: Colon 

1 

BIO 

/ Slash 


? Question mark 

agsDoan' 
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Portuguese Keyboard, 8-bit Characters, Data Processing keys 

8-bit Characters Data Processing Keys are the same as 8-bit 
Characters Typewriter Keys. 


Portuguese Keyboard, 7-bit Characters, Typewriter keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position 


Unshifted 


Shifted 


EOO 

D12 

CIO 

C12 


Dead 

Dead 


5 Small c w/Cedilla (7/12) 
Dead 


Dead 

Dead 


9 Capital C w/Cedilla (5/12) 
Dead 


Portuguese Keyboard, 7-bit Characters, Data Processing keys 
(Where different from 8-bit Characters, Typewriter keys) 


Position 


Unshifted 


Shifted 


Dll 

CIO 

Cll 


' Apostrophe 
Dead 

~ Tilde character 


' Open quote 
Dead 

^ Circumflex character 


TM 
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6.14.25 DECmate/WPS Main Key Array 

The LK201-BX Main Key Array is identical to LK201- Ax class, where 
X specifies the country, except that the Delete Key (E13) has the 
words Word and Char instead of Delete along with the "delete 
backward" symbol. In addition, the LK201-Bx main key array has 
the following gold legends on the front edge of the keys as shown 
below for the North American Version LK201-BA. 


Id 

Lower 

Upper 

Front edge 

EOO 

' open quote 

tilde 

Halt 

EOl 

1 

1 exclamation mark 


E02 

2 

@ Commercial at 


E03 

3 

# number sign 


E04 

4 

$ dollar sign 


E05 

5 

% percent 


E06 

6 

~ circumflex 


E07 

7 

& ampersand 


E08 

8 

* asterisk 


E09 

9 

( open paren 


ElO 

0 

) close paren 


Ell 

- minus 

underline 

Print Hyph 

E12 

- equals 

+ plus 

Abbrv 

DOl 

Q 


Super Script 

D02 

w 



D03 

E 



D04 

R 


Ruler 

DOB 

T 


Top Docmt 

D06 

Y 



D07 

u 



D08 

I 



D09 

0 



DIO 

p 


Page Marker 

Dll 

[ open bracket 

{ open brace 

Cmnd 

D12 

] close bracket 

} close brace 


COl 

A 


Sub Script 

C02 

S 


C03 

D 


Dead Key 

C04 

F 


File Docmt 

COB 

G 


Get Docmt 

C06 

H 



C07 

J 



C08 

K 



C09 

L 


Libry 

CIO 

; semicolon 

: colon 


Cll 

' apostrophe 

" double quote 

Replc 

C12 

\ backslash 

1 vertical line 

Date & Time 

C13 

Return 


Para marker 

BOO 

< less than 

> greater than 


BOl 

z 



B02 

X 




TM 
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LK201- BA Main Key Array Continued 


Id 

Lower 

Upper 

Front edge 

BOS 

C 


Center 

B04 

V 


View 

BOS 

B 


Bot Docmt 

B06 

N 


New Page 

B07 

M 


Menu 

B08 

, comma 

f comma 

Srch 

B09 

. period 

. period 

Cont Srch 

BIO 

/ slash 

? question 

mark Cont Srch & 
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The LK201-PA is identical to the LK201-NA and the LK201-PE is 
identical to the LK201-RE except for the gold legends on the front 
edge. Note that the gold legends on the front edge of the LK201- 
Px are not identical to the LK201- Bx. 

The difference between the LK201-RE and the LK201-NA is the front 
legends on the editing and numeric keypads. Therefore, the 
example below shows the LK201- Px, where x can be either {A, E} . 


6.14.25. 

Id 

1 English WPS- 

Legend 

Lower 

LK201- {PA, PE} - 

Upper 

Front Edge 

EOO 

' open quote 

tilde ch 


EOl 

1 

! exclamation mark 


E02 

2 

@ Commercial at 


EOS 

3 

# number sign 


E03** 

3 

£ 


E04 

4 

$ dollar sign 


EOS 

5 

% percent 


E06 

6 

circumflex 


E07 

7 

& ampersand 


E08 

8 

* asterisk 


E09 

9 

( open paren 


ElO 

0 

) close paren 


Ell 

- minus 

underline 

Print Hyph 

E12 

- equals 

+ plus 

Abbrv 

E13 

<X] 


Rub Line 

DOO 

Tab 


Indent Tab 

DOl 

Q 


Super Script 

D02 

W 


Write Docmt 

DOS 

E 



D04 

R 


Ruler 

DOB 

T 


Top Docmt 

D06 

Y 


Footnote 

D07 

U 



D08 

I 



D09 

0 



DIO 

P 


Page Marker 

Dll 

[ open bracket 

{ open brace 

Cmnd 

D12 

] close bracket 

} close brace 

Change Editor 

** There 

are three legends on E03, the shifted 

code generated 

this 

key is dependent 

upon which dialect. North American or 

British, is selected 

in set-up. 



mm 
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VSRM - 

Keyboard Processing 



LK201- 

{PA, PE) Main Key 

Array Continued 


Id 

Lower 

Upper 

Front edge 

COl 

A 



Sub Script 

C02 

s 



Spell Check 

C03 

D 



Dead Key 

C04 

F 



File Docmt 

COB 

G 



Get Docmt 

C06 

H 




C07 

J 



Lang Aids 

C08 

K 




C09 

L 



Libry 

CIO 

; semicolon 

• 

• 

colon 

Global Replc 

Cll 

' apostrophe 

tt 

double quote 

Replc 

C12 

\ backslash 

1 

vertical line 

Date & Time 

C13 

Return 



Para Marker 

BOO 

< less than 

> 

greater than 


BOl 

Z 



Status 

B02 

X 




B03 

c 



Center 

B04 

V 



View 

BOB 

B 



Bot Docmt 

B06 

N 



New Page 

B07 

H 



Menu 

EOS 

f c omnia 


comma 

Srch 

B09 

. period 

• 

period 

Cont Srch 

BIO 

/ slash 

? 

question mark 

Cont Srch & Sel 


SDEIDOil' 
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6.15 COMPOSE OPERATION 

Compose is used to generate characters which cannot be typed 
directly from the keyboard. Since there are many keyboards, some 
characters will be producible both via compose and via direct 
keyboard input. Characters often generated by compose include 
many of the accented European characters, special symbols such as 
the Yen Sign, and other normal characters not available on the 
particular keyboard. 

There are two forms of compose sequences: 

1. Implied compose sequence - a two key sequence initiated 
by a Non-Spacing Diacritical key. 

2. Explicit compose sequence - a three key sequence 
initiated by the Compose key. 

Graphic character keys used during an implied or explicit compose 
sequences are not auto-repeatable. This prevents the terminal 
user from accidentally repeating a key during a compose sequence. 


6.15.1 Compose With The Use Of The COMPOSE Key 

All characters which are not directly available on the keyboard 
can be generated with the use of the COMPOSE key followed by a two 
character generating sequence called a compose sequence. Many 
composable characters have more than one compose sequence, and can 
therefore be composed in more than one way. To compose a 
character the user types the following 3 keystrokes: 

1. COMPOSE 

2-. Character 1 (or Mark)* 

3. Character 2 (or Mark)* 

* Mark is used to mean a non-spacing diacritical mark or 
accent. 

When the user types the COMPOSE key, the COMPOSE LED is turned on 
to indicate that a compose is in progress. When the compose ends 
either successfully, by the depression of the delete key, or with 
an error, then the COMPOSE LED is turned off. If the Character 1 
and Character 2 pair form a valid compose sequence, then the 
compose is successful and the composed character is sent. If the 
Character 1 and Character 2 pair do not form a valid compose 
sequence then the Warning Bell rings once, if enabled in Set-up, 
to indicate a compose error, and no character is sent. 



TM 
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6.15.2 Compose With The Use Of Non-Spacing Diacritical Marks 

Many characters which are not directly available on the keyboard 
can be generated with the use of the implied compose feature. 
Non-Spacing Diacritical keys do not independently transmit 
character codes, but shall be used in combination with other keys. 
When these marks are typed an "implied compose" begins with the 
non-spacing diacritical mark as the first half of the compose 
sequence. Such an implied compose consists of two keystrokes as 
follows : 

1. Non-Spacing Diacritical Mark 

2. Character 

When the user types the non-spacing diacritical mark, the COMPOSE 
LED is turned on to indicate that a compose is in progress. When 
the compose ends either successfully, by depression of the delete 
key, or with an error, then the COMPOSE LED is turned off. If the 
non-spacing diacritical mark and character pair form a valid 
compose sequence, then the compose is successful and the composed 
character is sent. If the non-spacing diacritical mark and 
character pair do not form a valid compose sequence then the 
Warning Bell rings once, if enabled in Set-up, to indicate a 
compose error, and no character is sent. 


BBKID 
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6.15.3 Composing Arbitrary 8-bit Characters (VT330/340 Only, Not 
Mandatory) 


When the user types the COMPOSE Icey, and follows that key with two 
keys from the numeric keypad, an arbitrary 8-bit character is 
generated based on which numeric keypad keys are pressed. The two 
keys pressed specify an 8-bit code in hexadecimal digits: the 0 
through 9 keys specify the hexadecimal digits 0 through 9; the 
hexadecimal digits A through F are specified by the following 
keys: 

Key Name Hexadecimal Digit 


PFl A 

PF2 B 

PF3 C 

PF4 D 

Minus E 

Comma F 


The entire numeric keypad can then be thought of as a hexadecimal 
keypad: 


+ + + + + 

I A I B I C I D I 

+ + + + + 

1 7 I 8 I 9 I E I 

+ + + + + 


j_4_| 5 j 6J F j 


I 1 I 2 I 3 I * I 

+ + + + I 

! ° 1 * ! i 


* pressing either the Enter or 
Period keys will abort the 
compose sequence, and cause the 
function key to be sent to the 
host. 


BBSffiEID’' 
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Notes : 

1. Mixing a numeric keypad key and a main keypad key is not 
allowed, and will cause an error condition: the COMPOSE 
is aborted and the Warning Bell is rung. 

2. Arbitrary 8-bit composition obeys the Cl transmission 
state. If 7-Bit Controls are enabled, and Cl control 
generated by using compose on the numeric keypad is sent 
in the 7-Bit ESC Fe form. 

3. In VT52, VTlOO, and 4010/4014 modes, or in National 
character set mode, full 8-bit characters may not be 
generated by using compose on the numeric keypad. If the 
VT330/340 is in one of these modes, and the first key hit 
on the numeric keypad is 8, 9, PFl, PF2, PF3, PF4, Minus, 
or Comma, the COMPOSE is aborted and the Warning Bell is 
rung . 

4. This function is not affected by the setting of DECNKM 
(Numeric Keypad mode). 


TM 
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6.15.4 Use Of The COMPOSE Key When A Compose Is Already In 
Progress 

If the compose key is pressed while a compose sequence is in 
progress then the current compose sequence will be terminated and 
a new sequence will begin. The compose indicator remains on, the 
warning bell is not rung, no code is transmitted and a keyclick is 
generated if enabled. 


6.15.5 Use Of The DELETE Key When A Compose Is Already In 
Progress 

Typing the DELETE key will abort the compose immediately. No 
character is sent, the COMPOSE LED is turned off and the bell is 
not rung. 


SOiDDSD 
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6.15.6 Keystrokes Which Abort Compose Immediately 

A keystroke on any of the following keys aborts the compose in 
progress, does not ring the bell, sends no character codes, turns 
off the COMPOSE LED, and performs the local function normally 
performed by the keystroke: 

o Hold Screen Key 
o Print Screen Key 
o Set-Up Key 
o Switch Session Key 
o Break Key 

A Keystroke on any of the following keys (or key combinations) 
aborts the compose in progress, does not ring the bell, does not 
send the character code for any character entered earlier in the 
compose sequence, and sends the character code or codes normally 
transmitted by the keystroke which aborts the sequence: 

o Keypad keys 

o Function keys F6 through F20 including HELP and DO 
o Tab key 
o Return key 

o Ctrl-A through Ctrl-Z and all other Ctrl-Key combinations 
which produce control codes 
o Edit keypad keys 

o ESC, BS and LF (Fll, F12 and F13 in VTlOO mode) 

The Delete key aborts the compose, does not ring the bell, sends 
no character codes and turns off the COMPOSE LED. 


eKIDDSD' 
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6.15.7 Keystrokes Which Do Not Affect Compose Directly 

The following keys do not affect compose directly but they may 
affect compose indirectly. Their actions are the normal keyboard 
actions: 

o Shift 

o Control (When held alone) 


6.15.8 Order And Case Within Compose Sequences 

The importance of the order and case (upper or lower) of the two 
characters used to form a compose sequence depends on the 
character being composed. 


6.15.8.1 Order - 

The sequences for characters which have an obvious order (e.g., 
the "OE" ligature or the fraction) may not be reversed, while 

those for other characters may be. When the Compose key is used 
to initiate the sequence, the two following keys may be depressed 
in either order, unless the table entry for the composite 
character says "in order". When a Non-Spacing Diacritical key is 
used to initiate the sequence (implied compose), the diacritical 
key precedes the other key in the sequence. 


6.15.8.2 Case - 

The sequences for generating alphabetic characters are case 
sensitive, while those for other symbols are not. In instances 
where two alphabetic keys are used in the sequence, the minimum 
conforming implementation requires that the sequences of both keys 
in upper case and both keys in lower case be provided. It is 
optional to also provide the sequences in which one key is upper 
case and the other lower case. 
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6.15.9 Composition Conventions 

Mark is used to mean non-spacing diacritical mark. Some marks are 
also called accents. Each non-spacing diacritical mark has a 
character associated with it in the 8-bit Multinational character 
sets. Note that the mark, or accent, is not strictly the 
equivalent of its associated character. 


Mark 

Tilde mark 
Acute accent 
Circumflex accent 
Ring mark 

Dieresis or umlaut mark 

Grave accent 

Cedilla 


Associated Character 


~ Tilde character 
' Apostrophe 
"" Circumflex character 
° (degree sign) or asterisk 
" Double quote 
' Open quote 
, Comma 


Grave accent, tilde, and circumflex appear on all keyboards 
Diaeresis/umlaut mark and acute accent appear on certain non-US 
keyboards and are always Non-Spacing Diacritical keys. To 
distinguish diaeresis/umlaut mark from quotation marks (") which 
both appear on some keyboards, the diaeresis/umlaut mark is shown 
as two raised dots and quotation marks are short vertical lines on 
the key legends. Similarly, the acute accent is slanted and the 
apostrophe is shown vertical on the key legends. 


6.15.9.1 Compose Sequence Error Conditions - 

There are three different classes of compose sequence errors that 
may occur. 

The first class consists of dead keys which do not transmit any 
code. These include invalid control combinations, such as ctrl-9, 
and any other keys that are dead in the current operating 
environment. Dead keys are ignored within a compose sequence. 

The second class consists of sequences prematurely terminated by 
an illegal character. Illegal characters are all valid control 
combinations and all keys not from the main array of the keyboard. 
This includes Tab, Return, the Cursor Keys, keys from the Editing 
Keypad, keys from the Numeric Keypad, and the function keys 
(including the Local Function Keys). Such compose sequences are 
terminated as soon as the illegal character/key is typed. The 
compose led is turned off, and compose mode is exited. The 
offending character/key is considered to be outside of the 
sequence, and is handled normally (that is, a keyclick is 
generated, if enabled, and the code for the offending 
character/key is transmitted). The presence or absence of a 
keyclick, when enabled, indicates to the terminal user whether 
anything has been transmitted to the host or not. 
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The third class of compose errors consists of sequences containing 
legal characters from the main array of the keyboard but which do 
not form a valid compose sequence. Such compose sequences are 
terminated after the second character is typed. The procedure 
involves sounding the error bell (if it is enabled), turning off 
the Compose LED, and exiting compose mode. No code is transmitted 
by the terminal and nothing is displayed on the video display for 
the invalid compose sequence. The audible sound for a compose 
failure may be distinguishable from the sound produced by the 
receipt of the BEL control character and may be separately 
disabled via Set-up as an extension to Level 2. 
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6.15.9.2 Syntax Of Compose Sequences - 

The following syntax diagrams show all possible forms of valid and 
invalid explicit and implied compose sequences. All keys are 
divided into the following disjoint equivalence classes: 


Symbol 

C 

d 

a 

b 

X 

y 

F 

D 

C 


Meaning 
Compose Key 

Non-Spacing Diacritical key 

valid first key after Compose key 

valid second key after Compose key or first key 
after a Non-Spacing Diacritical key 

an invalid first key after Compose key 

an invalid second key after Compose key or first 
key after a Non-Spacing Diacritical key 

any function key or control character on the main key 
array or any other key outside of the main key array 
(including Local Function Keys) 

Delete key 

is the resulting composed one-byte character 
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Syntax Action 





Transmit 

LED 

bell 

Valid: 







C a 

b 

c 

off 

no 


C a 

d 

c 

off 

no 


C d 

b 

c 

off 

no 


d 

b 

c 

off 

no 

Corrected by 

terminal 

user : 




C a 

D 

nothing 

off 

no 


C d 

D 

nothing 

off 

no 


C X 

D 

nothing 

off 

no 


C D 


nothing 

off 

no 


d 

D 

nothing 

off 

no 

Started 

over 

by terminal user: 




C a 

C 

nothing 

on 

no 


C d 

C 

nothing 

on 

no 


C X 

C 

nothing 

on 

no 


C C 


nothing 

on 

no 


d 

C 

nothing 

on 

no 

errors : 

C a 

y 

nothing 

off 

yes 


C X 

y 

nothing 

off 

yes 


C X 

b 

nothing 

off 

yes 


C X 

d 

nothing 

off 

yes 


C d 

y 

nothing 

off 

yes 


C a 

F 

F 

off 

no 


C d 

F 

F 

off 

no 


C X 

F 

F 

off 

no 


C F 


F 

off 

no 


d 

F 

F 

off 

no 


d 

d 

nothing 

off 

yes 


d 

y 

nothing 

off 

yes 
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6.15.9.2,1 Compose Sequence Processing - The following algorithm 
defines the sequence of events which shall occur during the 
processing of an explicit or implied compose sequence. The 
algorithm is entered by the depression of the Compose key or a 
Non-Spacing Diacritical key. The Pascal coding which follows 
provides a detailed specification of the compose sequence logic. 


STEP 1: Process the first keystroke after the Compose key or process 

the Non-Spacing Diacritical keystroke. If the keystroke is: 

(1) Any graphic character key, Space Bar, or Non-Spacing Diacritical key: 
proceed to STEP 2. 

(2) A control character or any key not on the main key array: 
turn off the compose indicator, and exit compose mode. 

Then keyclick (if enabled) and transmit the code or 
sequence for the key just pressed. 

(3) Delete: turn off the compose indicator and exit compose mode. 

Keyclick (if enabled). Note that the error bell is not sounded 
and nothing is transmitted. 

(4) Compose: restart the compose sequence, keyclick (if enabled), and 
transmit nothing to the host until the new sequence is completed 
successfully. 

STEP 2: Process the second key after the Compose key or the 

key following a Non-Spacing Diacritical key. If the keystroke is: 

(1) A valid graphic character key or Non-Spacing Diacritical key 
(as defined in the tables) and if the preceding key 

is also valid: turn off the compose indicator, keyclick 

(if enabled), and transmit the corresponding DEC Multinational 

character code. 

(2) An invalid graphic character key or Non-Spacing Diacritical key, or 
the preceding key was invalid: ring the error bell, do not key 
click, turn off the compose indicator, and exit compose mode. 

(3) A control character or any key not on the main key array: 
turn off the compose indicator, and exit compose mode. 

Then keyclick (if enabled) and transmit the code or 
sequence for the key just pressed. 

(4) Delete: turn off the compose indicator and exit compose mode. 

Keyclick (if enabled). Note that the error bell is not sounded. 

(5) Compose: restart the compose sequence, keyclick (if enabled), and 
transmit nothing until the new sequence is completed successfully. 
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PROCEDURE PROCESS_COMPOSE_SEQUENCE (KEY: KEY_CODE); 

(* 

This procedure is called whenever the Compose key or a Dead 
Diacritical keystroke occurs and the terminal is not already 
in compose mode. 

The key code of the initiating key is passed in the call. 

The procedure calls the following external routines, which 
should be self-explanatory: 

key :- GET_NEXT_KEY (KEY_CODE); 

TURN_ON_COMPOSE_LED ; 

TURN_OFF_COMPOSE_LED ; 

RING_ERROR_BELL ; 

GENERATE_KE Y_CL I CK ; 

TRANSMIT_COMPOSED_CHAR ( KEY_1 , KEY_2 : KEY_CODE); 
TRANSMIT_CONTROL_FUNCTION ( KEY_1 ) ; 

It also calls the function 

VALID_C0MP0SE_SEQUENCE(KEY_1, KEy_2 : KEY_CODE, 

SUPPLEMENTAL_SET: VALID_SUPPLEMENTAL_SETS ) : BOOLEAN; 

which returns True if the two keys form a valid compose 
sequence as defined in the tables in this section. 

*) 

CONST COMPOSE = (* the key code representing the Compose key *) 
DELETE = (* the key code representing the Delete key *) 
TYPE KEY_CODE - 0..255; 

SPACE_GRAPHIC_DIACRITICAL_SET - SET OF (* The key codes 
representing SPACE and graphic characters from 2/0 
to 7/14 inclusive, 10/1 to 15/14 inclusive, and the 
Non-Spacing Diacritical characters *); 

VAR KEY_1, KEY_2: KEY_CODE; 

IN COMPOSE MODE: BOOLEAN; 
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BEGIN 

TURN_ON_COMPOSE_INDICATOR; 

KEY_1 KEY; 

IN_COMPOSE_MODE:=« TRUE; (* set loop flag, clear to exit loop *) 
WHILE IN_COMPOSE_MODE DO (* restart on Compose key *) 

BEGIN 

WHILE KEY_1 - COMPOSE DO 
BEGIN 

GENERATE_KEY_CLICK ; 

KEY_1 GET_NEXT_KEY; 

END; 

CASE KEY_1 OF 

SPACE_GRAPHICAL_DIACRITICAL_SET: (* have KEY_1 , go get KEY_2 *) 

GENERATE_KEY_CLICK; 

DELETE : 

BEGIN 

GENERATE_KEY_CLICK; 

IN_COMPOSE_MODE FALSE; 

END 

OTHERWISE: 

BEGIN 

IN_COMPOSE_MODE FALSE; 

GENERATE_KEY_CLICK; 

TRANSMIT_CONTROL_FUNCTION ( KEY_1 ) ; 

END 

END; (* end case on first key of pair *) 
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IF IN_COMPOSE_MODE THEN 

(* Process second key of explicit or implied compose pair *) 
BEGIN 

KEy_2 GET_NEXT_KEY ; 

CASE KEY_2 OF 

SPACE_GRAPHIC_DIACRITICAL_SET; 

IF VALID_COMPOSE_SEQUENCE ( KEY_1 , KEY_2 ) THEN 
BEGIN (* valid pair *) 

GENERATE_KEY_CLICK ; 

TRANSMIT_COMPOSED_CHAR ( KEY_1 , KEY_2 ) ; 

IN_COMPOSE_MODE FALSE; 

END 

ELSE (* invalid pair *) 

ERROR_PROCEDURE ; 

DELETE: (* Delete *) 

BEGIN 

GENERATE_KEY_CLICK; 

IN_COMPOSE_MODE FALSE; 

END; 

COMPOSE: {* Compose *) 

GENERATE_KEY_CLICK; 

OTHERWISE: (* not Compose, SPACE, graphic, diacrit. or DEL *) 
BEGIN 

IN_COMPOSE_MODE := FALSE; 

GENERATE_KEY_CLICK ; 

TRANSMIT_CONTROL_FUNCTION ( KEY_2 ) ; 

END 

END; (* end case *) 

END; (* end case on second key of pair *) 

END; (* end loop that Compose Key starts over *) 

TURN_OFF_LED; 

END; (* end procedure PROCESS_COMPOSE_SEQUENCE *) 

PROCEDURE ERROR_PROCEDURE ; 

BEGIN 

RING_ERROR_BELL ; 

IN_COMPOSE_MODE FALSE; 

END ; 
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6.15.10 8-bit Characters Mode Valid Compose Sequences 

6.15.10.1 Compose Sequences For Characters Without Diacritical 
Marks - 

Note when the Compose key is used to initiate the sequence, the 
two following keys may be depressed in either order, unless the 
table entry explicitly says "in order". 


CHARACTER 


SEQUENCES 


* 


+ 

+ 







@ 


a 

a 

A 

A 

a 

A 



[ 


( 

( 







\ 


/ 

/ 

/ 

< 





] 


) 

) 







{ 


( 

- 







1 


/ 








} 


) 

- 







<NBSP> No Break Space 

SP SP 







<I I> 

1 

1 

! 







<c/> 

Cent 

C 

/ 

C 

/ 

c 

1 

C 

1 

<L-> 

Pound Sign 

L 

- 

1 

- 

L 


1 


<XO> 

General currency 

X 

0 

X 

0 

X 

0 





X 

0 

X 

0 

X 

o 



<Y-> 

Yen 

Y 

- 

y 

- 

Y 

- 

y 


<1 l> 

Broken vertical bar 

1 

1 

1 






<So> 

Section Sign 

S 

1 

s 

0 

S 

0 

s 

O 



s 

1 

s 

0 

S 

0 

s 

O 

<CO> 

Copyright 

c 

0 

c 

o 

C 

0 





c 

0 

c 

o 

c 

0 



< a> 

Feminine ordinal 


a 


A 





<<<> 

Angle quotes left 

< 

< 







<-,> 

Logical not sign 

- 

, ( in 

order ) 





<SHY> Soft hyphen 

- 

- 







<RO> 

Reg. Trademark 

R 

0 

R 

o 

R 

0 





r 

0 

r 

o 

r 

0 
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<-"> 

Macron 


<+-> 

Plus-minus 

+ - 

<2"> 

Superscript 2 

2 ^ 

<3"> 

Superscript 3 

3 " 

</u> 

HU/ Micro sign 

/ u / U ( in order ) 

<!P> 

Paragraph 

IP ! p 


Middle dot 

A 

• 

<1"> 

Superscript 1 

1 ^ 

< o> 

Masculine ordinal 

o 0 

<>>> 

Angle quote right 

> > 

<14> 

Quarter 

1 4 (in order) 

<12> 

Half 

1 2 (in order) 

<34> 

Three Quarters 

3 4 (in order) 

<??> 

Inverted ? 

? ? 

<AE> 

AE ligature 

A E ( in order) 

<-D> 

Cap Icelandic Eth 

D - 

<OE> 

OE ligature 

0 E (in order) 

<xx> 

times sign 

XX XX XX 

<0/> 

0 slash 

0 / 

<TH> 

Icelandic Thorn 

T H (in order) 

<ss> 

6 

s s 

<ae> 

ae ligature 

a e (in order) 

<-d> 

Sm Icelandic Eth 

d - 

<oe> 

oe ligature 

o e (in order) 

<-;> 

division sign 

• 

• 

<o/> 

o slash 

o / 

<th> 

Sm Icelandic Thorn 

t h (in order) 

<0"> 

0 

0 " 

SP “ (space degree) 

SP * (space asterisk) 


tilde character 

SP ~ (space tilde-mark) 

1 

open quote 

SP ' (space open-quote) 
space grave-accent 


apostrophe 

SP ' (space apostrophe) 
space acute-accent 

<"> 

acute accent 

' ' (apostrophe apostrophe) 

acute-accent acute-accent 

'' circumflex character 

SP ^ (space circumflex-accent) 

II 

double quote 

SP " (space double— quote ) 
space dieresis 

A. 

3 

> 

V 

dieresis 

" " (double-quote double-quote) 

dieresis dieresis 


cedilla 

, , (comma comma) 
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6.15.10.2 Compose Sequences For Characters With Diacritical Marks 
For composition of the following composite characters, either the 
mark or the associated character (s) may be used in the compose 
sequence. The compose sequence consists of one of the following: 

o Mark, Basic Character 

o COMPOSE, Associated Character, Basic Character 

o COMPOSE, Basic Character, Associated Character 

o COMPOSE, Mark, Basic Character 

o COMPOSE, Basic Character, Mark 

Where the basic character is the alphabetic character without the 
accent or mark. For example the basic character in <U"> is U. 

Associated 

Mark Character Composite Characters 


Grave Accent ' single quote <A' ><a' ><E’ ><e ’ XI ' ><i ' ><0' ><o' > 

<U' ><u' > 

<A'><a' ><E' ><e' XI ' ><i 'XO' ><o' > 
<U'Xu'xy'Xy'> 

<A"xa"XE"Xe"XI''Xi''XO'‘Xo^> 
<U^Xu"> 

Tilde Mark ~ tilde <A~xa~XN~xn~XO~Xo~> 


" quotations <A"xa"XE"xe"xi”xi"xO"xo"> 
<U"Xu"XY"Xy"> 

* asterisk <A*xa*> 

or degree 

, comma <C,Xc,> 


Dieresis 
or Umlaut Mark 

Ring Mark 
Cedilla 


Acute Accent ' apostrophe 

Circumflex Accent circumflex 


SDUDDil 
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6.15.10.3 Non-Spacing Diacritical Marks By Keyboard - 

See the position keyboard map for details. The following is a 
list of non-spacing characters which do an implied compose. The 
list is by keyboard. The most recent or recommended variation for 
each dialect is listed first. Note: This table applies to 
keyboard maps (as specified in Set-Up), not physical keyboards. 


1. North American (LK201-EE US/UK or LK201-AA) - none 


2. British (LK201-EE US/UK) - none 


3. British (LK201-AE) 
EOO Tilde Mark 
C12 Circumflex Mark 
C12 Grave Accent 


4. Flemish (LK201-AB) 

EOO Grave Accent 
EOO Tilde Mark 
Dll Circumflex Accent 
Dll Dieresis 


5. Canadian (French) (LK201-AC) 

EOO Tilde Mark 
Cll Grave Accent 

Cll Circumflex Accent (shifted) 


6. Danish (2nd, LK201-ED) - none 


7. Danish (1st, LK201-AD) 

EOO Tilde Mark 

E12 Acute Accent 

E12 Grave Accent (shifted) 

D12 Dieresis 

Dl2 Circumflex Accent (shifted) 


8. Finnish (3rd, LK201-NX) - none 


9. Finnish (1st, LK201-AF) 

EOO Tilde Mark 

E12 Circumflex Accent 

El2 Grave Accent (shifted) 


( shifted) 

( shifted) 
( shifted) 


mmr 
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10. Austrian/German (2nd, LK201-NG) - none 


11. Austrian/German (1st, LK201-AG) 

EOO Tilde Mark 

EOO Circumflex Accent (shifted) 

El2 Acute Accent 

E12 Grave Accent (shifted) 


12. Dutch (2nd, LK201-NH) - none 


13. Dutch (1st, LK201-AH) 
EOO Tilde Hark 
Dll Circumflex Accent 
Dll Dieresis 
Cll Grave Accent 
Cll Acute Accent 


14. Italian (LK201-AI) 

EOO Grave Accent 

EOO Tilde Mark (shifted) 

E08 Circumflex Accent 


15. Swiss (French) (LK201-AK) 

E12 Circumflex Accent 

El2 Grave Accent (shifted) 

Dl2 Dieresis 

D12 Tilde Mark (shifted) 


16. Swiss (German) (LK201-AL) 

E12 Circumflex Accent 

E12 Grave Accent (shifted) 

D12 Dieresis 

D12 Tilde Hark (shifted) 


17. Swedish (2nd, LK201-NM) - none 


18. Swedish (1st, LK201-AM) 

EOO Tilde Mark 

El2 Circumflex Accent 

E12 Grave Accent (shifted) 


19. Norwegian (2nd, LK201-EN) - none 


( shifted) 
( shifted) 
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20. Norwegian (1st, LK201-AN) 

EOO Tilde Mark 

El2 Acute Accent 

E12 Grave Accent (shifted) 

D12 Dieresis 

Dl2 Circumflex Accent (shifted) 


21. Belgian/French (LK201-AP) 

EOO Grave Accent 

EOO Tilde Mark (shifted) 

Dll Circumflex Accent 

Dll Dieresis (shifted) 


22. Spanish (LK201-AS) 
Dll Grave Accent 
Dll Circumflex Accent 
Cll Acute Accent 
Cll Dieresis 
C12 Tilde Mark 


23. Portuguese (LK201-AV) 

Cll Tilde Mark 

Cll Circumflex Accent (shifted) 

Dll Acute Accent 

Dll Grave Accent (shifted) 


6.15.10.4 Valid Compose Sequences And The Supplemental Character 
Sets - 

Depending on the Supplemental character set chosen in Set-Up 
(either DEC Supplemental or ISO Latin-1 Supplemental), there are 
some changes in the compose sequences available to create 8-bit 
characters, as a direct result of the lack of some characters in 
either of the character sets. 

The following table specifies which characters are not available 
in each of the supplemental character sets. Compose sequences 
which choose the characters listed cannot be composed when that 
supplemental character set is chosen through Set-Up; 


( shifted) 

( shifted) 
( shifted) 


mm 
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\ 


DEC Supplemental (not available) 


160 

166 

168 

172 

173 

174 

175 
180 
184 
190 
208 
215 
221 
222 
240 
247 

253 

254 


<NBSP> no break space 

<||> broken vertical bar 

<""> dieresis 

<-,> logical not 

<SHY> soft (syllable) hyphen 

<RO> registered trademark sign 

<-"> macron 

<''> acute accent 

< , , > cedilla 

<34> fraction three quarters 
<-D> capital Icelandic Eth 
<xx> times sign 

<Y'> capital Y with acute accent 

<TH> capital Icelandic thorn 

<-d> small Icelandic Eth 

<-:> division sign 

<y'> small y with acute accent 

<th> small Icelandic thorn 


ISO Latin-1 Supplemental (not available) 


215 <OE> capital OE ligature 
221 <Y"> capital Y with dieresis 
247 <oe> small oe ligature 

There are also two characters in different positions between the 
ISO Latin-1 Supplemental and DEC Supplemental character sets. For 
these two character sets, the appropriate compose sequence is 
present when either set is invoked. Only the code transmitted to 
the host changes: 

Character DEC Supplemental ISO Latin-1 Supplemental 

Name Coding Coding 


<OX> general currency 168 164 

<y"> small y w/dieresis 253 255 


Deviation Note 

On the VT320, VT330, and VT340, there is one set 
of compose sequences whose result changes 
depending on whether the ISO Latin-1 Supplemental 
or DEC Supplemental character set is chosen in 
Set-Up: 

Compose 
Sequences 


<dieresis> <space> 
<space> <dieresis> 


DEC Supplemental ISO Latin-1 
Result Result 


34 - " quotation 168 - 

marks dieresis 


SQSQQSD~ 
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This difference has been deprecated. "<dieresis> 
<space>" should produce double quote in both DEC 
Supplemental and ISO Latin-1. 
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6.15.11 7-bit Characters Mode Valid Compose Sequences 

6.15.11.1 Typewriter Keys Valid Compose Sequences By Keyboard 
(7-bit Characters) - 

The following details all of the valid COMPOSE sequences for each 
keyboard when the terminal is in 7-bit Characters mode, and 
Typewriter Keys are selected. A separate selection of compose 
sequences is given for Data Processing Keys, regardless of 
Keyboard type, because when Data Processing keys is selected in 
7-bit Characters mode, the ASCII character set, and not the 
associated NRCS, is used in GO. No COMPOSE sequences other than 
those listed for any one keyboard are legal when that keyboard is 
selected and is in 7-bit Characters mode. Note: This table 
applies to keyboard maps as specified in Set-Up, not physical 
keyboards. 


1. North American (LK201-EE US/UK) 

7-bit Characters mode is not available with the North 
American keyboard. 


2. British (LK201-EE US/UK) - Typewriter Keys 
Character Sequences 


space quotations 
quotations space 
-L L- -1 1- 

-L L- -1 1- 

space apostrophe 
apostrophe space 
aa AA Aa aA 

( ( 

/ / / < < / 

) ) 

space '' (circumflex) 

^ (circumflex) space 
space ' (grave accent) 
' (grave accent) space 
( - - ( 

) - - ) 

space ~ (tilde) 

(tilde) space 


" quotations 

<L-> UK pound 

' apostrophe 

@ commercial at 
[ opening bracket 
\ backslash 
] closing bracket 

circumflex character 

' grave accent 

{ opening brace 
I vertical bar 
} closing brace 
~ tilde 


eim 
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3. Flemish (LK201-AB) - Typewriter Keys 


Character 


Sequences 


" quotations 
<L»> UK pound 
* apostrophe 
<a'> small a with grave 
< 0 "> “ 

<c,> small c with cedilla 
<So> S 

' grave accent 
<e'> small e with acute 

<u'> small u with grave 

<e'> small e with grave 

circumflex 


space quotations 
quotations space 
-L L- -1 1- 

•L L* *1 1“ 

space apostrophe 
apostrophe space 
' (grave accent) a 
a ' (grave accent) 

0 " 0 
space degree 
degree space 


Space 

•k 




* space 

c , 

9 

c 




1 s 

s 

1 

t 

s 

S ! 

o s 

s 

o 

o 

s 

S o 

0 S 

s 

0 

0 

s 

S 0 

0 s 

s 

0 

0 

s 

S 0 


space ’ (grave accent) 
' (grave accent) space 
apostrophe e 
e apostrophe 
' (grave accent) u 
u ' (grave accent) 

' (grave accent) e 
e ' (grave accent) 
space " 
space 
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4. French (Canada) (LK201-AC) - Typewriter Keys 
Character Sequences 


" quotations space quotations 

quotations space 

# pound ( numbe r ) s i gn 

' apostrophe space apostrophe 

apostrophe space 

<a'> small a with grave grave a a grave 

<a'“> small a with circumflex circumflex-accent a 

a circumflex-accent 

<c,> small c with cedilla c , , c 

<e''> small e with circumflex circumflex-accent e 

e circumflex-accent 
<!'■> small i with circumflex circumflex-accent i 

i circumflex-accent 
<o''> small o with circumflex circumflex-accent o 

o circumflex-accent 

<e'> small e with acute apostrophe e 

e apostrophe 

<u'> small u with grave grave u u grave 

<e'> small e with grave grave e e grave 

<u''> small u with circumflex circumflex-accent u 

u circumflex-accent 


5. Danish (2nd, LK201-ED) - Typewriter Keys 
Character Sequences 


" quotations 

# pound (number) sign 
' apostrophe 

@ commercial at 
<AE> capital R 
<0/> capital 0 with slash 
<A*> capital A with ring 
^ circumflex 

' grave accent 

<ae> small s 

<o/> small o with slash 

<a*> small a with ring 

~ tilde 


space quotations 
quotations space 
+ + 

space apostrophe 
apostrophe space 
aa AA Aa aA 
A E 

O / / O 

A asterislc asterisk A 
space " 

^ space 

space ' (grave accent) 

’ (grave accent) space 
a e 

o / / o 

a asterisk 
asterisk a 
space ^ (tilde) 

(tilde) space 


nan 
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6. Finnish (3rd, LK201-NX) - Typewriter Keys 


Character 


Sequences 


" quotations 
# pound (number) sign 


' apostrophe 

@ commercial 
<A"> capital 
<0"> capital 
<A*> capital 

<U"> capital 
<e'> small e 
<a"> small a 
<o"> small o 
<a*> small a 

<u"> small u 


at 

A with umlaut 
0 with umlaut 
A with ring 

U with umlaut 
with acute 
with umlaut 
with umlaut 
with ring 

with umlaut 


space quotations 
quotations space 
+ + 

space apostrophe 
apostrophe space 
aa AA Aa aA 
quotations A A quotations 
quotations 0 0 quotations 

A asterisk asterisk A 
A <0''> <0"> A 

quotations U U quotations 
apostrophe e e apostrophe 
quotations a a quotations 
quotations o o quotations 
a asterisk asterisk a 
a <0'‘> <0'‘> a 

quotations u u quotations 


7. Austrian/German (2nd, LK201-NG) - Typewriter Keys 
Character Sequences 


" quotations 

# pound (number) sign 
' apostrophe 

<So> S 


<A"> capital A with umlaut 
<0"> capital 0 with umlaut 
<U"> capital U with umlaut 
^ circumflex character 


' grave accent 


<a"> 

small 

a 

with 

umlaut 

<o"> 

small 

o 

with 

umlaut 

<u"> 

<ss> 

small 

8 

u 

with 

umlaut 


space quotations 
quotations space 
+ + 

space apostrophe 
apostrophe space 
Is si IS SI 

os so oS So 

Os sO OS SO 

Os sO OS SO 

quotations A A quotations 
quotations 0 0 quotations 

quotations U U quotations 
space ^ (circumflex) 

" (circumflex) space 
space ’ (grave accent) 

' (grave accent) space 
quotations a a quotations 
quotations o o quotations 

quotations u u quotations 
s s 


eigmiD 
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8. Dutch (2nd, LK201-NH) - Typewriter Keys 

7-bit Characters mode is not available with the Dutch 
Keyboard (same as North American). 


9. Italian - Typewriter Keys 


Character 




Sequences 


" quotations 



space quotations 







quotations space 


<L-> 

UK pound 


- L L - - 1 

1 - 






* L L - - 1 

1 - 

' apostrophe 



space apostrophe 







apostrophe space 


<So> 

§ 




! s si ! S 

S ! 






os so o S 

S o 






Os s 0 OS 

S 0 






Os s 0 OS 

S 0 

O 

> 

V 

0 




O'* 0 

space * * 

space 

A 

n 

V 

small 

c 

with 

cedilla 

c , , c 


A 

(D 

V 

small 

e 

with 

acute 

apostrophe e 
e apostrophe 


circumflex 

character 

space ^ (circumflex) 






'' (circumflex) space 

A 

V 

small 

u 

with 

grave 

grave-accent u 
u grave-accent 


<a’> 

small 

a 

with 

grave 

grave-accent a 
a grave-accent 


A 

o 

V 

small 

o 

with 

grave 

grave-accent o 
o grave-accent 


<e’ > 

small 

e 

with 

grave 

grave-accent e 
e grave-accent 


A 

H- 

V 

small 

i 

with 

grave 

grave-accent i 
i grave-accent 



soisaEm' 
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10. Swiss (French) (LK201-AK) - Typewriter Keys 
Character Sequences 


" quotations space quotations 

quotations space 

<u'> small u with grave grave-accent u 

u grave-accent 

' apostrophe space apostrophe 

apostrophe space 

<a'> small a with grave grave-accent a 

a grave-accent 

<e'> small e with acute apostrophe e 

e apostrophe 

<c,> small c with cedilla c , , c 

<e''> small e with circumflex circumflex-accent e 

e circumflex-accent 

<i“> small i with circumflex circumflex-accent i 

i circumflex-accent 

<e'> small e with grave grave-accent e 

e grave-accent 

<o'‘> small o with circumflex circumflex-accent o 

o circumflex-accent 

<a"> small a with umlaut umlaut-mark a 

a umlaut-mark 

<o"> small o with umlaut umlaut-mark o 

o umlaut-mark 

<u"> small u with umlaut umlaut-mark u 

u umlaut-mark 

<u‘'> small u with circumflex circumflex-accent u 

u circumflex-accent 


mm" 
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11. Swiss (German) (LK201-AL) 
Character 


Typewriter Keys 
Sequences 


" quotations 

<u’> small u with grave 

' apostrophe 

<a'> small a with grave 

<e'> small e with acute 

<c,> small c with cedilla 

<e'‘> small e with circumflex 

<!'“> small i with circumflex 

<e'> small e with grave 

<o^> small o with circumflex 

<a"> small a with umlaut 

<o"> small o with umlaut 

<u"> small u with umlaut 

<u''> small u with circumflex 


space quotations 
quotations space 
grave-accent u 
u grave-accent 
space apostrophe 
apostrophe space 
grave-accent a 
a grave-accent 
apostrophe e 
e apostrophe 
c , , c 

circumflex-accent e 
e circumflex-accent 
circumflex-accent i 
i circumflex-accent 
grave-accent e 
e grave-accent 
circumflex-accent o 
o circumflex-accent 
umlaut-mark a 
a umlaut-mark 
umlaut-mark o 
o umlaut-mark 
umlaut-mark u 
u umlaut-mark 
circumflex-accent u 
u circumflex-accent 


mmn 
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12. Swedish (2nd, LK201-NM) - Typewriter Keys 
Character Sequences 


" quotations 

# pound (number) sign 
' apostrophe 


<E'> capital 

<A"> capital 
<0"> capital 
<A*> capital 

<U"> capital 
<e'> small e 

<a"> small a 
<o"> small o 
<a*> small a 

<u"> small u 


E with acute 

A with umlaut 
0 with umlaut 
A with ring 

U with umlaut 
with acute 

with umlaut 
with umlaut 
with ring 

with umlaut 


space quotations 
quotations space 
+ + 

space apostrophe 
apostrophe space 


apostrophe E 
E apostrophe 
quotations A 
quotations 0 
A asterisk 
A <0''> <0''> 

quotations U 
apostrophe e 
e apostrophe 
quotations a 
quotations o 
a asterisk 
a <0"> <0~> 

quotations u 


A quotations 
O quotations 
asterisk A 
A 

U quotations 


a quotations 
o quotations 
asterisk a 
a 

u quotations 


13. Norwegian - Typewriter Keys 


Character 


Sequences 


" quotations 

# pound (number) sign 
' apostrophe 

@ commercial at 
<AE> capital R 
<0/> capital 0 with slash 
<A*> capital A with ring 
circumflex 

' grave accent 

<ae> small ae 

<o/> small o with slash 

<a*> small a with ring 

tilde 


space quotations 
quotations space 
+ + 

space apostrophe 
apostrophe space 
aa AA Aa aA 
A E 

0 / / 0 

A asterisk asterisk A 
space " 

^ space 

space ’ (grave accent) 

' (grave accent) space 
a e 

o / / o 

a asterisk 
asterisk a 
space ~ (tilde) 

(tilde) space 


BSD- 
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14. French (Belgium) (LK201-AP) - Typewriter Keys 


Character 


Sequences 

" quotations 


space quotations 
quotations space 

<L-> UK pound 


-L L- -1 1- 

-L L- -1 1- 

' apostrophe 


space apostrophe 
apostrophe space 

<a'> small a with 

grave 

' (grave accent) a 
a ' (grave accent) 

<0"> “ 


0 ~ "0 

space degree 

degree space 

space * * space 

<c,> small c with 

cedilla 

o 

o 

<So> S 


! s S ! ! S S ! 
os so oS So 
Os SO OS SO 
Os sO OS SO 

' grave accent 


space ’ (grave accent) 

’ (grave accent) space 

<e'> small e with 

acute 

apostrophe e 
e apostrophe 

<u'> small u with 

grave 

' (grave accent) u 



u ' (grave accent) 

<e'> small e with 

grave 

' (grave accent) e 
e ' (grave accent) 

^ circumflex 


space " "" space 


mmm 
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15. Spanish (LK201-AS) - Typewriter Keys 


Character 


Sequences 


" quotations 
<L-> UK pound 
' apostrophe 
<So> S 

<!}> inverted ! 

<N~> capital N with tilde 

<??> inverted ? 

^ circumflex character 

' grave accent 

< 0 ^> » 

<n~> small n with tilde 

<c,> small c with cedilla 
tilde 


space quotations 
quotations space 
-L L- -1 1- 

-L L- -1 1- 

space apostrophe 
apostrophe space 
! s si IS Si 

os so oS So 

Os sO OS SO 

Os sO OS SO 

I I 

(tilde) N 
N ~ (tilde) 

? ? 


space (circumflex) 

^ (circumflex) space 
space ’ (grave accent) 
' (grave accent) space 
0 ~ ‘0 


space * * space 

~ (tilde) n 
n ~ (tilde) 
c , , c 

space ~ (tilde) 

(tilde) space 


16. Portuguese (LK201-AV) - Typewriter Keys 


Character 


Sequences 


" quotations 

' apostrophe 

@ commercial at 
<A''> capital A with tilde 
<C,> capital C with cedilla 
<0~> capital 0 with tilde 
^ circumflex character 


grave accent 


<a~> 
<c , > 

> ^ V 


small a with tilde 
small c with cedilla 
small o with tilde 
tilde character 


space quotations 
quotations space 
space apostrophe 
apostrophe space 
aa AA Aa aA 

A ~ (tilde) ~ (tilde) A 

C C 

0 ~ (tilde) ~ (tilde) 0 
space (circumflex) 
(circumflex) space 
space ’ (grave accent) 

' (grave accent) space 
a ~ (tilde) ~ (tilde) a 

Of f o 

o ~ (tilde) ~ (tilde) o 

space ~ (tilde) 

(tilde) space 


TM 
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6.15.11.2 Typewriter Keys Non-Spacing Diacritical Marks By 
Keyboard (7-bit Characters) - 

The following lists all the non-spacing diacritical marks while 
the terminal is in 7-bit Characters mode, with Typewriter Keys 
selected. Note: This table applies to keyboard maps as specified 
in Set-Up, not physical keyboards. 


1. North American (LK201-EE US/UK or LK201-AA) - not 
applicable . 


2. British (LK201-EE US/UK) - none 


3. British (LK201-AE) - none 


4. Flemish (LK201-AB) 

EOO Grave Accent 

Dll Circumflex Accent 

Dll Dieresis (shifted) 


5. Canadian (French) (LK201-AC) 

Cll Grave Accent 

Cll Circumflex Accent (shifted) 


6. Danish (2nd, LK201-ED) - none 


7. Danish (1st, LK201-AD) 

EOO Ring Mark (shifted) 

Dl2 Dieresis 


8. Finnish (3rd, LK201-NX) - none 


9. Finnish (1st, LK201-AF) - none 


10. Austrian/German (2nd, LK201-NG) - none 


11. Austrian/German (1st, LK201-AG) - none 


12. Dutch (2nd, LK201-NH) - not applicable 


emiDiiir 
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13. Dutch (1st, LK201-AH) - none 


14. Italian (LK201-AI) 

EOO Grave Accent 
E08 Circumflex Accent 


15. Swiss (French) (LK201-AK) 

E12 Circumflex Accent 

E12 Grave Accent (shifted) 

Dl2 Dieresis 


16. Swiss (German) (LK201-AL) 

El2 Circumflex Accent 

E12 Grave Accent (shifted) 

D12 Dieresis 


17. Swedish (2nd, LK201-NM) - none 


18. Swedish (1st, LK201-AM) - none 


19. Norwegian (2nd, LK201-EN) - none 


20. Norwegian (1st, LK201-AN) 

EOO Ring Mark (shifted) 

Dl2 Dieresis 


21. Belgian/French (LK201-AP) 

EOO Grave Accent 

Dll Circumflex Accent 

Dll Dieresis (shifted) 


22. Spanish (LK201-AS) 
Dll Grave Accent 
Dll Circumflex Accent 
Cll Acute Accent 
Cll Dieresis 
C12 Tilde Mark 


23. Portuguese (LK201-AV) 
Cll Tilde Mark 
Cll Circumflex Accent 
Dll Acute Accent 
Dll Grave Accent 


( shifted) 
( shifted ) 


( shifted ) 

( shifted) 
( shifted ) 


Sgugseig- 
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6.15.11.3 Data Processing Keys Valid Compose Sequences - 

The following compose sequences are valid when the terminal is in 
7-bit Characters mode, with Data Processing keys selected, 
regardless of the keyboard selected. 

When in 7-bit Characters Mode, with Data Processing keys selected, 
the ASCII character set is used, instead of the applicable 
National Replacement Character set. Therefore, compose sequences 
to generate the special characters and symbols in the several NRCS 
are not available when Data Processing Keys is selected. 

All Keyboards - Data Processing Keys 


Character 


” quotations 

# pound (number) sign 
' apostrophe 

@ commercial at 
[ opening bracket 
\ backslash 
] closing bracket 
^ circumflex character 

' grave accent 

{ opening brace 
I vertical bar 
} closing brace 
~ tilde 


Sequences 


space quotations 
quotations space 
+ + 

space apostrophe 
apostrophe space 
aa AA Aa aA 

( ( 

/ / / < < / 

) ) 

space ~ (circumflex) 
(circumflex) space 
space ’ (grave accent) 
' (grave accent) space 
( - - ( 

) - - ) 

space ~ (tilde) 

(tilde) space 


6.15.11.4 Data Processing Keys, Non-Spacing Diacritical Marks - 

There are no non-spacing diacritic keys in 7-bit Characters mode 
when Data Processing Keys are selected, because no such key is 
required to produce a character from the ASCII character set. 


nsD' 
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6.16 CONTROL CODES AND KEYSTROKES 

The following codes will be transmitted when the control key is 
depressed simultaneously with another key: 



HEX 

Code 


Legend 

Transmitted 

Name 

Ctrl-space 

00 


NUL 

Ctrl-2 

00 


NUL 

Ctrl-A 

01 


SOH 

Ctrl-B 

02 


STX 

Ctrl-C 

03 


ETX 

Ctrl-D 

04 


EOT 

Ctrl-E 

05 


ENQ 

Ctrl-F 

06 


ACK 

Ctrl-G 

07 


BEL 

Ctrl-H 

08 


BS 

Ctrl-I 

09 


HT 

Ctrl-J 

OA 


LF 

Ctrl-K 

OB 


VT 

Ctrl-L 

OC 


FF 

Ctrl-M 

OD 


CR 

Ctrl-N 

OE 


SO 

Ctrl-0 

OF 


SI 

Ctrl-P 

10 


DLE 

Ctrl-Q 

11 


DCl 

(Only if 

XOFF handling is 

disabled 

Ctrl-R 

12 


DC2 

Ctrl-S 

13 


DC3 

(Only if 

XOFF handling is 

disabled 

Ctrl-T 

14 


DC 4 

Ctrl-U 

15 


NAK 

Ctrl-V 

16 


SYN 

Ctrl-W 

17 


ETB 

Ctrl-X 

18 


CAN 

Ctrl-Y 

19 


EM 

Ctrl-Z 

lA 


SUB 

Ctrl-3 

IB 


ESC 

Ctrl-[ 

IB 


ESC 

Ctrl-4 

1C 


FS 

Ctrl-\ 

1C 


FS 

Ctrl-5 

ID 


GS 

Ctrl-] 

ID 


GS 

Ctrl-6 

IE 


RS 

Ctrl-~ 

lE 


RS 

Ctrl-7 

IF 


US 

Ctrl-? 

IF 


US 

Ctrl-8 

7F 


DEL 

Ctrl-Tab 

09 


HT 

Ctrl-Enter 

( same 

as ENTER 

alone ) 

Ctrl-Return 

( same 

as RETURN 

alone ) 

Ctrl-Delete 

18 


CAN 
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Notes : 

1. The Shift key is ignored when pressed in combination with 
Control . 

2. On the number keys (EOl-ElO), the control-numeral 
combination takes precedence over the other legend (if 
the control-numeral combination is valid) regardless of 
the shift state. 

3. On the North American keyboard, the control-tilde 
combination is used for the Open Quote/Tilde key (Tilde 
is the shifted legend on EOO, Control Open_quote is not a 
valid control combination). 


eiDB- 
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6,17 SUMMARY OF MODES 

The following table summarizes the modes that affect the keyboard 
and/or character transmission. Those modes that do not have a 
symbol are local Set-Up modes only and are not setable from the 
host. Those modes that do not have an LED are indicated as blank. 


Name of Mode 

Symbol/LED 

Reset Name 

Set Name 


Host Port 


Environment * 


Seven_Bit 

Eight_Bit 

Keyboard Usage *** 

DECKBUM**** 

Typewriter 

Data Processing 

Conformance Level 

DECSCL 

Level 1 

Level_2 Level 

Hold Screen ** 

Hold Screen 

Hold_Of f 

Hold On 

Lock Key ** 

Lock 

Unlocked 

Locked 

Caps/Shift Lock 


Caps_Lock 

Shif t_Lock 

Compose * and ** 

Compose 

Compose_Of f 

Compose_On 

Keyboard Action 

KAM/Wait 

Unlocked 

Locked 

Auto Repeat *** 

DECARM 

Repeat_Of f 

Repeat_On 

Keyclick * 


Keyclick_Of f 

Keyclick_On 

Cursor Key 

DECCKM 

Cursor 

Ck_Application 

Keypad 

DECKPAM/DECKPNM Numeric 

Kp_Application 


DECNKM 

Numeric 

Kp_Application 

New Line 

LNM 

New_Line_Of f 

New_Line_On 

Cl Transmission 

S7C1T/S8C1T 

Seven Bit 

Eight_Bit 

Character Set Mode 

DECNRCM 

8-bit Char's 

7-bit Characters 

UPSS*** 

DECAUPSS 

DEC-MCS 

ISO Latin-1 

Keyboard Dialect* 
Delete Key* 


Delete 

Backspace 

Compose Key* 


Enable 

Disable 

Break Key* 


Enable 

Disable 


Notes; 

* - Set-Up mode only (no coded representation) 

** - Activated by terminal user by typing keys (no coded 
representation) 

*** - Terminal user convenience feature - not to be issued by 
software except in response to the wishes of the terminal user 

**** _ Extension to Level 2, required in Level 3 


eDmo' 
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6.18 CHANGE HISTORY 
6.18.1 Revision 0.0 To 0.1 
All sections: 

1. Renumbered sections so as to put related information 
together. Organized material according to physical areas 
of the keyboard. 

2. Added change bars to any change that could effect 
conformance or interpretation of the document or should 
be brought to the attention of terminal implementors or 
software engineers. 

Section 3 - Terminology: 

3. Added terminology section. 

Section 4 - Physical Keyboard Description: 

4. Clarified that Lock key is not effected by typing Shift 
key. 

5. Clarified that Compose indicator also comes on for 
implied compose. 

6. Clarified that XON and XOFF do NOT set Hold Screen 
Indicator, only Hold Screen Key does. 

Section 5 - Conformance Requirements: 

7. Made conformance requirement specific, including keys, 
control functions related to the keyboard and local 
Set-Up features. 

8. Indicated that Caps lock Operation is the factory default 
mode (not Shift Lock Operation) in order to be compatible 
with the VTIOO. 

9. Indicated that disabling the error bell is a Level 2 
extension. 

10. Require GR Transmission Mode for Level 2. 

Section 7 - Functions and State for all keyboard areas: 

11. Changed so that all keys that send codes also 
auto-repeat. 

12. Indicated that keys in an implied or explicit compose 
sequence do not auto-repeat. 


emo' 


Digital Internal Use Only 



EL-00070-06 

VSRM - Keyboard Processing 


19-Apr-1988 


Page 6-174 


13. Indicated that all keys, including Compose and Lock keys, 
keyclick, except Shift and Control keys. 

14. Indicated that keys that are inoperative when GR 
Transmission Mode is NO_GR, do not keyclick. 

15. Corrected the coding for KAM parameter value. 

16. Indicated that KAM disabled keyclick too. 

17. SELECT CONFORMANCE LEVEL (DECSCL) unlocks the keyboard. 
Section 8 - Cursor Keys: 

18. Corrected coding for DECCKM. 

19. Clarified that Cursor Keys depend only on Cursor Key Mode 
and are independent of Keypad Application/Numeric Mode. 

Section 9 - Keypad; 

20. Enter key always auto-repeats, independent of keypad 
mode . 

Section 11 - Application Function Key Row: 

21. Added internal documentation about Bill Hefner allocating 
application function keys between operating system and 
application programs to prevent conflict and increase 
compatibility. 

22. Set-Up mode restores terminal modes and screen when 
exited. 

23. Hold Screen does not update the screen (not just prevents 
scrolling) . 

Section 13 - Main Key Array: 

24. Caps lock operation transmits upper case of lower case 
alphabetic even when it is on the same key with another 
symbol . 

25. Indicated that Non-Spacing Diacritical keys behave the 
same after implied and explicit compose sequences have 
started. 

26. Switched [ with ] on Canadian (French), German/Austrian, 
and Spanish data processing keyboards so that they are 
like all other keyboards that have them on the same key 
([ is in shifted position). 
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27. Removed Ctrl-[ from Canadian (French) Data processing 
keyboard to generate ESC. Now like all other non-US 
keyboards that only use numbers with Ctrl to get NUL, 

ESC, FS, GS, RS, US, and DEL. 

28. Clarified that Compose indicator goes on when Non-Spacing 
Diacritical key pressed too. 

29. Removed implementor option to transmit compose key 
strokes for invalid compose sequences. 

30. When GR Transmission Mode is NO_GR, 7-bit explicit 
compose sequences are still required, but Non-Spacing 
Diacritical keys are immediately inoperative. 

31. Indicated that a distinguishable bell sound on compose 
errors is an extension to Levels 1 and 2. 

32. Indicated that the error bell can be separately disabled 
by the terminal user as an extension to Levels 1 and 2. 

33. Clarified that error bell is echoed if a compose is ended 
by a function key, even though the function key is 
transmitted (and key clicked). 

34. Compose key does keyclick. Lock, Shift, and Control 
don't key click. 

35. Compose error doesn't keyclick on last key stroke. 

36. Non-Spacing Diacritical keys keyclick, but do not 
auto-repeat . 


mmr 
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6.18.2 Revision 0.1 To 0.2 
All sections: 

1. Removed Rev 0.1 change bars. Added change bars to any 
change that could effect conformance or interpretation of 
the document or should be brought to the attention of 
terminal implementors or software engineers. 

2. In the coded format sections, removed most of the 7-bit 
notation since the only difference is CSI (9/11) in 
8-bits versus ESC [ (1/11 5/11) in 7-bits. This is not a 
specification change, only a presentation change. 

3. In the coded format sections, added the 8-bit column/row 
decimal notation used in ANSI and ISO standards 
immediately below the graphic character notation, e.g., 
immediately below CSI 2 h is 9/11 3/2 6/8. 

Section 3 - Terminology: 

4. Added concept of "permanent label strip" and "removable 
label strip" of which the latter can be "system label 
strip" or an "application label strip". 

5. Changed all references of "foreign keyboards" to "non-US 
keyboards". 

Section 4 - Physical Keyboard Description: 

6. Added concept of "product class" of keyboards for 
LK201-AX (standard keyboard), LK201-Bx (DECmate II), 
LK201-CX ( VAXworkstation ) , LK201-DX (Generic Video), 
LK201-EX (Generic Hardcopy). The DEC Standard keyboard 
is intended to be used on most video terminals sold with 
DEC systems, except DECmate II and VAX Workstations. 
Generic is intended to be used on non-DEC systems or by 
OEMs that have their own software. 

7. VAXworkstation has "Symbol" instead of "Compose" an 
implements it as a shift key, rather than a modal prefix 
key. 

8. Added DECmate II and EDT keypad legends. 

9. DECmate II Delete key has Word and Char instead so can 
delete previous character and previous word (holding 
Control Key down). 

10. Added the Permanent Label Strips for each of the five 
above product classes and changed the Function row to 
always be blank (to agree with what we are shipping). 

11. Added the Professional System Label Strip and RAINBOW 100 
System Label Strip. 
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12. Changed the names of keyboard versions to be country with 
language in parentheses (only when needed). Removed all 
alternate country names. Art Len and Martin Hall agreed 
with this simplification. 

13. Introduced the concept of "usage mode" to distinguish 
typewriter layout from data processing layout, rather 
than calling them different versions, since both modes 
are labeled on the same version of the keyboard. 

14. Described keys not present on most non-U. S. typewriter 
modes (11 characters) and data processing modes (5). 


15. Removed GR_Transmission Mode (setable from host) and 
replaced it with the Host Port Environment Mode (which is 
only a Set-Up feature and which is required for Level 2 
conformance but is optional for Level 1 conformance). 

Section 5 - Conformance 

16. Removed Requirement to implement Keyclick Mode as a 
Set-Up feature. It is an implementor option. Section 11 
- Application Function Key row; 

17. Corrected Level 1 coding for Fl2 and F13 keys (from 1/8 
and 1/10 to 0/8 and 0/10) to agree with ASCII for BS and 
LF. 

Section 13 - Main Key Array; 

18. Put versions in increasing alphabetical order by version 
numbe r . 

19. When in Shift Lock Operation (as opposed to Caps Lock 
Operation), the Shift key rather than the Lock key is 
pressed again to leave the locked state. 

20. Clarified that New Line Mode does not effect ctrl/M. 
ctrl/M always transmits just 0/13. 

21. Corrected the coding of the Q keys (DOl and COl) to agree 
with ASCII (7/2 changed to 7/1 and 5/2 changed to 5/1). 

22. Corrected Denmark LK201-xD in Data processing mode key 
CIO from 0 w/slash (15/8, 13/8) to E (14/6, 12/6). 
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23. Corrected Italy LK201-XI (both modes) to show that E08 
circumflex is a Non-Spacing Diacritical key that starts 
an implied compose sequence. 

24. Spain LK201-xS (typewriter mode) changed EOO upper from 
invert question mark (11/15) to invert exclamation mark 
( 10 / 1 ). 

25. Clarified that keyclick indicates whether something was 
transmitted to the host or not, even in compose errors. 

26. Indicated additional compose error combinations in the 
table . 

Section 14 - Summary of modes 

27. Added this section for easy reference. 
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6.18.3 Revision 0.2 To AXlO 


1. Reorganized first five sections of the document. 

2. Removed all references to the Dx and Ex classes of 
keyboard, and modified aill legend tables to reflect this 
change. 

3. Removed descriptions of Application Label Strips pending 
software strategy on label strip distribution control, 
and added a note to the System Label Strip table 
indicating that it is not required for conformance. 

4. Added Japan (Katakana) Version LK201-xJ keyboard. 

5. Corrected an error in the description of Keyboard Action 
Mode which referred to the Lock LED instead of the Wait 
LED. 

6. Added notes to the description of Auto-Repeat to soften 
the conformance requirements, making it clear that 
variable repeat rates are not a required function, and 
that the delay in turning off auto-repeat when the DECARM 
control is received is UNDEFINED. 

7. Added codes for Local Function Keys used in combination 
with Shift and Control, and for Compose Key when not 
implemented as a local function. 

8. Added a deviation note to the description for New Line 
Mode to indicate that previous terminals caused New Line 
Mode to effect the operation of Control-M. 

9. Corrected the code transmitted by Control-Q in all of the 
keyboard tables (it was 1/2, and should be 1/1). 

10. Corrected the tables for the Denmark Version LK201-xD 
keyboard (both modes) which had errors on key ids CIO and 
Cll. 

11. Added a note that the Local Function Keys will terminate 
a Compose Sequence. 

12. Added a note to the Compose Sequence tables to indicate 
that order is significant only where specifically 
indicated in the tables. 
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13. Removed the error bell from the Compose error recovery 
for keys which terminate the Compose sequence and 
transmit their normal codes, such as control keys and 
Function keys. 

14. Removed the error bell from the definition of inoperative 
keys. 

15. Removed the restriction on the use of Non-Spacing 
Diacritical Keys in Level 1 operation to allow valid 
7-bit Compose sequences to be introduced by Non-Spacing 
Diacritical Keys. 

16. Removed Hold Screen interactions with communications 
functions, particularly XON/XOFF, and added references to 
the section "Code Extension Layer". 

17. Added a note that some control characters may be used as 
Local Function Keys when required by the communications 
protocol . 

18. Changed the implementation of Caps Lock. Only keys with 
upper case characters on the legends will be effected by 
Caps Lock. Keys with one or more lower case diacritical 
characters will not be effected. All keyboard code 
tables were changed to reflect this. 

19. Added a note that for Compose sequences consisting of two 
alphabetic characters, it is required to implement the 
sequences with both characters upper case and both lower 
case. It is optional to also implement the sequences 
with one character upper case and the other lower case. 

20. Removed Local Function Key codes to the appendix 
"Documented Exceptions". 

21. Changed the description of Lock Key to indicate that it 
works the same in both Shift Lock and Caps Lock Mode. 

22. Added notes the Cursor Key Mode and Keypad Mode to 
indicate that any inter-dependencies are UNDEFINED in 
Level 1 operation, but they must be independent in Level 
2 operation. 
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6.18.4 Revision AXIO To AXll 
All sections: 

1. Removed all revision AXIO change bars. Added change bars 
to any change that could effect conformance or 
interpretation of the document or should be brought to 
the attention of terminal implementors or software 
engineers. 

2. Removed all references to echoing the error bell as part 
of the error recovery for dead keys. 

Section 5 - Physical Keyboard Description 

3. Removed note on VAXstation Keyboard Lock Indicator. 
Section 6 - Control Functions And State 

4. Added. ESC to the list of keys which do not auto repeat. 

5. Clarified rules defining which keys click. All keys 
which transmit codes, or cause the terminal to take some 
immediate action click. 

Section 9 - Editing Keypad Keys 

6. Removed statement that the codes transmitted by the 
Editing keypad keys are not effected by Control, Shift, 
or Lock. Added statement that these keys are inoperative 
when pressed in combination with Shift or Control. 

Section 10 - Application Function Keys 

7. Removed statement that the codes transmitted by the 
Application Function Keys are not effected by Control. 
Added statement that these keys are inoperative when 
pressed in combination with Control. 

Section 12 - Main Key Array 

8. Removed reference to keyclick behavior in section on 
special keys and functions. 

9. Removed statement that the codes transmitted by Space Bar 
and Delete are independent of Control, Shift, and or Lock 
keys. Fixed table to show Control Delete sends 1/8. 

10. Changed section on Control key operation to indicate that 
alternate forms for keying CO controls are available on 
non-US keyboards whenever the keys involved in these 
combinations are present. 

11. Added paragraph documenting behavior of auto repeat when 
Control is pressed. 
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12. Added statement that pressing Shift does not turn off 
lock in section on Lock Key Operation. 

13. Added, statement that delete key clicks when used to 
cancel a compose sequence. 

14. Added paragraph documenting how British £ is handled in 
7-bit mode on the British keyboard. 

15. Corrected description of compose sequence error 
conditions and recovery. Dead keys are ignored while in 
a compose sequence. Illegal compose characters cancel 
the compose sequence but do not sound the error bell. 
Pressing Compose within a compose sequence clicks if 
keyclick is enabled. 

16. Added new compose sequences for back slash, S, and °. 


EKD 
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6.18.5 Revision AXll To AX12 
All sections: 

1. Removed all revision AXll change bars. Added change bars 
to any change that could effect conformance or 
interpretation of the document or should be brought to 
the attention of terminal implementors or software 
engineers . 

2. Removed all references to LK201-CX 

3. Replaced the term Dead Diacritical Mark with Non-Spacing 
Diacritical Mark to reflect current usage. 

4. Re-organized keyboard features into categories by whether 
they affect coding or user interaction to group 
functionally related features together. 

5. Updated entire standard to reflect latest country 
keyboards, 8-bit Architecture (ISO Latin-1), and NRCS 
support . 

Section - 1 Introduction 

6. Added subsection on keyboard product classes to explain 
model designations (LK201-xx). 

7. Added explanation of Keyboard Versions and Dialects to 
show which keyboards are described in this chapter, and 
which are the most recent (recommended) and superseded 
keyboards for each country market (Keyboard Dialect). 

Section - 2 Conformance Requirements 

8. Added Level 3 conformance requirements. 

9. Added description of Level 3 operation. 

10. Expanded Keyboard Character Encoding section to cover 
"8-bit Architecture" and "NRCS Extension". 

Section - 3 Referenced Standards and Related Publications 

11. Updated referenced standards to include document order 
number and full name of standard. 

12. Added reference to "&LK201 Functional Sped f ication\& . 

13. Added information on how to order cited documents. 

Section - 4 Terminology 

14. Added definitions for "Keyboard Usage Mode" and "Keyboard 
Dialect" . 
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Section - 5 Physical Keyboard Description 

15. Documented front legends for Editing and Numeric Keypads 
for LK201- {NA, PA} (VT330/VT340 Local Edit Mode 
legends) . 

16. Described system legend strip variations for G99 as "Hold 
Session", GOO as "Local Print", and G02 as "Switch 
Session" for multiple session terminals. 

17. Described system legend strip variations for G02 as "F4" 
or "Data/Talk". 

Section - 6 Keyboard Operation and State that Affects 
User Interaction 

18. Clarified section on Keyboard Output Silo. Added 
guideline "The VT320 provides a 25 keystroke silo". 

19. Extended list of conditions that can reset Keyboard 
Action Mode to include Entering Set-Up in Level 1, Clear 
Comm, and Terminal Reset. 

20. Added sentence that control and shift keys do not cause a 
new delay before auto-repeating new code (if any). 

21. Broke out information on keys not effected by auto repeat 
mode, created a new section. Added additional keys that 
were not part of the original list. 

22. Created section on auto repeat guidelines to show timing 
considerations for actual terminals. 

23. Defined an upper limit on the time between when a DECARM 
control is received and the time a key which was already 
auto-repeating stops repeating when terminal is 
processing host output (to allow testing for 
conformance ) . 

24. Clarified section on Visual Indicators. 

25. Expanded section on Audible Indicators to include Warning 
Bell and Margin Bell. Added paragraph describing 
interaction of keyclick and bells. 

Section - 7 Keyboard State and Operating Modes that 
Affect Keyboard Encoding 

26. Added summary of modes that affect keyboard encoding at 

beginning of section. Added new modes: BackArrow Key 
mode, Disable Compose mode. Added new Set-Up options: 
Remap shifted to <>, Remap <> to Remap to ESC, 

Remap KP, to SPACE. 

27. Documented Terminal Emulation mode not previously covered 
(VT52 and VTlOO, VT200 and VT300). 
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28. Added description of "Character Set Mode" to cover NRCS 
Extension. Made NRCS support more intuitive by 
organizing as 7-bit/8-bit Characters instead of 
National/Multinational. Added algorithm for 
setting/resetting character set mode. 

29. Greatly expanded explanation of Keyboard Usage Mode. 

Added summary of Data Processing characters for each 
keyboard dialect. Added description of new DECKBUH 
control function. 

30. Greatly expanded explanation of Keyboard Dialect 
(selection of country keyboards) to cover NRCS Extension 
and latest country keyboard layouts. Added list showing 
NRC set to be used for each keyboard dialect. 

31. Added detailed explanation of how Combined US/UK keyboard 
works with North American and British keyboard dialects. 

32. Added description of User Preference Supplemental Set 
(UPSS) to cover 8-bit Architecture Extension. 

Section - 9 Numeric Keypad Keys 

33. Added description of DECNKM control function. 

Section - 12 Local Function Keys 

34. Expanded explanation of Hold Screen function to include 
"Hold Session" on multi-session terminals. Referenced 
new Terminal Synchronization chapter for explanation of 
Hold Screen interaction with flow control. 

35. Included section on Local Function key F4 as used with 
the VT330/340 ( Switch Session ) , and VT220 (Data/Talk). 

36. Expanded explanation of Break Key operation to include 
Disable Break option. 

Section - 13 Main Key Array - Special Keys and Functions 

37. Clarified example of the ctrl-number construct. 

38. Referenced new section on Control Codes and Keystrokes. 

39. Added notes on control key operation with keys from the 
editing keypad and function keys. 

40. Expanded explanation of Lock Key operation. 

41. Added description of DEL/BS option for Backarrow key on 
VT300 series terminals. 

42. Added description of "Hold Session" for multiple session 
terminals ( VT330/VT340 ) . 


TM 


Digital Internal Use Only 



EL-00 07 0-06 

VSRM - Keyboard Processing 


19-Apr-1988 


Page 6-186 


43. Expanded description of "Data/Talk" key as used for VT220 
integral modem. 

44. Noted f 4 is dead if not used for a local function. 

45. Added explanation of Disable Compose option. 

Section - 14 Main Key Array - Graphic Character Keys 

46. Clarified keyboard character set encoding. 

47. Explained precedence rules for unshifted, caps-lock, 
shift-lock, shift, and control. 

48. Removed most coding (where obvious) from tables and 
referenced DEC STD 169 on character sets. 

49. Updated graphic character tables to include latest 
keyboards, and support for NRCS Extension. 

50. Re-organized subsection to provide tables for 8-bit 
typewriter and Data Processing keys, as well as 7-bit 
typewriter and Data Processing keys for each Keyboard 
Dialect and country keyboard in one place. 

51. Listed complete table only once per keyboard dialect, 
then listed differences to simplify understanding the 
affect of each keyboard mode. 

52. Each table fits on one page and is clearly identified 
(Keyboard Dialect, 8-bit/7-bit Characters, 

Typewri ter/Data_Processing , layout version within 
dialect, which physical keyboards table is intended for). 

53. Added table for main key array for the LK201- {PA, NA} in 
the DECMate/WPS section. 

Section - 15 Compose Operation 

54. Expanded section on Compose Operation. 

55. Provided tables for valid compose sequences in 8-bit and 
7-bit Characters Mode (NRCS Extension) with and without 
non-spacing diacriticals . 

56. Added compose sequences for 8-bit Architecture Extension 
(ISO Latin-1) as implemented in VT300 family. 

57. Added section on choice of supplemental sets and compose 
operation. 
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58. Eliminated the one compose sequence that produces a 
different character in ISO Latin-1 versus DEC 
Supplemental. COMPOSE <dieresis> <space> should produce 
'double quote' in both DEC Supplemental and ISO Latin-1 
for backward compatibility and consistency with acute 
accent. Noted VT320, VT330, and VT340 as deviations. 

59. Simplified table of compose sequences for 8-bit 
characters without non-spacing diacriticals by listing 
each sequence in only one order. Added note that order 
can be reversed unless table entry explicitly says "in 
order". Added phrase "in order" to every order sensitive 
entry. 

60. Added VT330/VT340 numeric keypad ( hexidecimal ) compose 
feature. 

61. Added "Switch Session" key to list of keys which abort 
compose immediately. 

62. Added table summarizing non-spacing diacriticals for each 
keyboard dialect. 

Section - 16 Control Codes and Keystrokes 

63. Put control codes into one table in new section. 

Section - 17 Summary of Modes 

64. Updated summary of modes. 
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Section 

Application Function Key, 6-32, 

6-70 

Application Function Key Row 
within compose sequence, 6-141 
Application Function Keys, 6-15, 
6-28, 6-30 

Application Label Strip 
definition, 6-25 
Application Process, 6-12, 6-14 
definition, 6-25 
Auto Print Mode, 6-73 
Auto Repeat 

within compose sequence, 6-134 
Auto Repeat Mode, 6-16, 6-40, 

6-172 

8-bit Architecture Extension, 

6-21 

Break Key, 6-74 
Byte 

definition, 6-25 

Cl Transmission Mode, 6-61, 6-64, 
6-66, 6-69, 6-70, 6-172 
Caps Lock, 6-16, 6-17, 6-77, 6-78, 
6-82, 6-172 

Caps/Shift Lock Mode, 6-16, 6-17, 
6-77, 6-78, 6-82, 6-172 
Character 

definition, 6-25 
Character Set Mode, 6-22, 6-172 
Coded Character 
definition, 6-25 
Coding Interface, 6-12, 6-14 
definition, 6-25 
Compose, 6-12, 6-44 
Compose Key, 6-12, 6-44 
Compose LED, 6-30, 6-44, 6-141 
Compose Mode, 6-172 
Compose Sequence, 6-12, 6-19, 

6-20, 6-44, 6-81 
algorithm, 6-145 
auto repeat, 6-134 
buffering, 6-37 
cancelling, 6-138 
case within, 6-140 


Index 

definition, 6-25 
errors, 6-141 

explicit, 6-20, 6-26, 6-42, 
6-79, 6-80, 6-134, 6-140, 
6-145 

implied, 6-26, 6-42, 6-79, 
6-134, 6-140, 6-145 
order within, 6-140 
restarting, 6-138 
syntax, 6-143 
Compose sequence 
implied, 6-80 
Compose Sequences, 6-54 
Conformance 

keyboard, 6-15 

Conformance Level, 6-17, 6-38, 
6-70, 6-172 
Control Character 
definition, 6-25 
Control Function 
definition, 6-25 
Control Key, 6-61, 6-63, 6-69, 
6-70, 6-75 
auto repeat, 6-42 
with new line mode, 6-79 
with shift key, 6-77 
within compose sequence, 6-141 
Cursor Key, 6-28, 6-60, 6-61, 
6-62 

within compose sequence, 6-141 
Cursor Key Mode, 6-16, 6-60, 
6-172 

Cursor Keypad, 6-33 
Dead Key 

within compose sequence, 6-141 
DEC STD 070-12, 6-23 
DEC STD 070-3, 6-23 
DEC STD 070-4, 6-23 
DEC STD 070-7, 6-23 
DEC STD 107, 6-12, 6-13, 6-15, 
6-23, 6-26, 6-30, 6-75 
DEC STD 169, 6-15, 6-23 
DECARM, 6-41 
DECCKM, 6-62 
DECKBUM, 6-57 
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DECKPAM, 6-66 
DECKPNM, 6-67 
DECmate/WPS 

Main Key Array, 6-130 
DECNKM, 6-68 
DECNRCM, 6-52 
Delete Key, 6-80 

with shift key, 6-77 
Diacritical Hark 
definition, 6-25 

Editing Keypad Front Legends, 

6-32 

Editing Keypad Key, 6-15, 6-19, 
6-28, 6-32, 6-69, 6-70 
within compose sequence, 6-141 
Envi ronment 

definition, 6-25 
Escape Key 

auto repeat, 6-42 
Explicit Compose Sequence, 6-20, 
6-42, 6-79, 6-80, 6-134, 

6-140 

algorithm, 6-145 
definition, 6-26 
External Interface, 6-14 

Graphic Character 
definition, 6-26 

Hold Screen Key, 6-44, 6-72 
Hold Screen LED, 6-30, 6-44, 6-72 
Hold Screen Mode, 6-44, 6-172 
Host Port 

definition, 6-26 

Host Port Environment Mode, 6-15, 
6-16, 6-19, 6-20, 6-22, 6-47, 
6-172 

Human Interface, 6-12 


Implied Compose Sequence, 6-42, 
6-79, 6-80, 6-134, 6-140 
algorithm, 6-145 
definition, 6-26 
Inoperative 

definition, 6-26 
Input Processing, 6-13 
Internal Interface, 6-14 
ISO 8859-1, 6-24 


KAM, 6-39 
Key 

definition, 6-26 
Key Legend 

definition, 6-26 
Key Position ID, 6-28 
definition, 6-26 
Keyboard, 6-15 

Keyboard Action Mode, 6-16, 6-38, 
6-172 

Keyboard Areas, 6-28 
Keyboard Dialect 
definition, 6-26 
Keyboard Dialects, 6-9 
table, 6-10 
Keyboard Layouts, 6-9 
Keyboard Lock, 6-44 
Keyboard Map 
logical, 6-30 
physical, 6-28 
Keyboard Usage Mode 
data processing, 6-54 
definition, 6-26 
typewriter, 6-54 
Keyboard Usage Modes, 6-82 
data processing, 6-15, 6-28, 
6-30, 6-172 

typewriter, 6-28, 6-30, 6-172 
Keyboard Versions, 6-9, 6-15, 
6-28, 6-30, 6-54, 6-82 
Keyclick, 6-19, 6-39, 6-46, 6-69, 
6-70 

with control key, 6-75, 6-76 
within compose sequence, 6-141 
Keyclick Mode, 6-46, 6-172 
Keypad Mode, 6-16, 6-63, 6-65, 
6-66, 6-67, 6-68, 6-172 

Label Strip 

application, 6-25 
permanent, 6-26, 6-30, 6-35, 
6-70 

removable, 6-27, 6-70 
system, 6-27 
LEDs 

compose, 6-30, 6-44, 6-141 
hold screen, 6-30, 6-44, 6-72 
legends, 6-30, 6-35 
lock, 6-30, 6-44 
wait, 6-30, 6-38, 6-44 
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Legend 

definition, 6-26 
Level 1 

keyboard, 6-15 
Level 2 

keyboard, 6-15 

LK201, 6-7, 6-8, 6-9, 6-15, 6-23 
Local Function Key 

within compose sequence, 6-141 
Local Function Keys, 6-28, 6-30, 
6-44, 6-70, 6-72, 6-77 
auto repeat, 6-42 
Lock Key, 6-44, 6-61, 6-63, 6-69, 
6-70, 6-75, 6-77, 6-82 
with control key, 6-75 
Lock Key Mode, 6-44, 6-172 
Lock LED, 6-30, 6-44 
Logical Keyboard Map, 6-30 

Main Key Array, 6-9, 6-28 
Modes 

auto print, 6-73 
auto repeat, 6-16, 6-40, 6-41, 
6-172 

Cl transmission, 6-172 
caps/shift lock, 6-16, 6-17, 
6-77, 6-78, 6-82, 6-172 
character set mode, 6-22, 6-52, 
6-172 

compose, 6-172 
conformance level, 6-172 
cursor key, 6-16, 6-60, 6-62, 
6-172 

hold screen, 6-44, 6-172 
host port environment, 6-15, 
6-16, 6-19, 6-20, 6-22, 
6-47, 6-172 

keyboard action, 6-16, 6-38, 
6-39, 6-172 
keyboard usage, 6-57 
keyclick, 6-46, 6-172 
keypad,- 6-16, 6-63, 6-65, 6-66, 
6-67, 6-68, 6-172 
lock key, 6-44, 6-172 
national replacement character 
set mode, 6-52 
new line, 6-16, 6-65, 6-75, 
6-79, 6-172 

numeric keypad mode, 6-172 
printer port environment, 6-172 


National Keyboards, 6-12 
New Line Mode, 6-16, 6-65, 6-75, 
6-79, 6-172 

with control key, 6-79 
Non-Spacing Diacritical Key, 6-12, 


6-26, 6-42, 

6-44, 

o 

00 

1 

VO 

6-134 

6-140, 6-145 




definition, 6- 

25 



NRCS Extension, 

6-21, 

6-22, 

6-81 

Numeric Keypad, 

6-33 




Numeric Keypad Front Legends, 

6-34 

Numeric Keypad Key, 6-28, 6-62, 
6-63, 6-65, 6-66, 6-67, 6-68 
codes generated, 6-64 
within compose sequence, 6-141 
Numeric Keypad Mode, 6-172 
control function, 6-68 

Permanent Label Strip, 6-30, 6-35, 
6-70 

definition, 6-26 
Physical Keyboard Map, 6-28 
Print Screen Key, 6-73 
Printer Port 

definition, 6-26 
Printer Port Environment Mode, 
6-172 

Product Class 

DEC Standard, 6-35 
DECmate/WPS, 6-35 

Receive 

definition, 6-27 
Reference Standards, 6-23 
Removable Label Strip, 6-70 
definition, 6-27 
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Document Identifier: A-DS-EL00070-07-0 Rev AX12, 28-Apr-1987 


ABSTRACT: This section describes the characteristics of the 
Printer Port extension to the Level 2 and Level 3 Character Cell 
Display service class. It includes both the control functions 
required to cause transmission from the terminal to the printer, 
and the syntax of the coded interchange at the printer port. 
Note: The Level 1 Printer Port Extension consists of a sub-set of 
the functions described in this standard. At the present time 
there is no separate specification of the Level 1 required 
functions. 
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7.1 INTRODUCTION 


The use of a Printer Port forms an extension to the Level 1, Level 
2, and Level 3 Character Cell Display service classes. A 
conforming device may provide an auxiliary communications port 
which can be used to support a printing device. A means shall be 
provided to transfer data from the display to the printer port, as 
well as to relay data received at the host port directly to the 
printer port. The device must transfer data from the display, 
including the character codes, character renditions, and character 
sets, on a per-line, per-scrolling region, per-screen, and 
per-page basis. 

The Printer Port uses serial asynchronous communications with 
independently setable communication parameters. Level 3 requires 
a fully bi-directional printer port to allow printer to host 
communication in addition to local printing (not mandatory for 
Level 1 or Level 2). 


7.2 TERMINOLOGY 


Auto Print Mode - A printer port control which, when set, causes 
the contents of the Active Line to be transmitted to the printer 
port whenever the Active Position is moved off the Active Line as 
a result of a Line Feed, Form Feed or Vertical Tab command, or 
autowrap. 

Fallback Transmission - A substitute transmission used when a 
character cannot be transmitted in a particular mode; for 
instance, when in NATIONAL and LINE DRAWING mode and a character 
from the DEC Supplemental set is encountered. 

Printer Controller Mode - A printer port control that causes all 
data received at the host port to be transferred directly to the 
printer port without interpretation by the display terminal. 

I Printer To Host Mode - A printer port control that causes all data 
I received at the printer port (other than XON/XOFF flow control) to 
I be relayed to the host. 

Print Extent Mode - A printer port control used to select the area 
I ' of the display to be transmitted to the printer port when a Print 
I Page operation is performed. 

Print Form Feed Mode - A printer port control which, when set, 
transmits a Form Feed (FF) control character to the printer at the 
I conclusion of each Print Page or Print Screen operation. 

Printer Port - An auxiliary communicat^ion port that supports a 
printing device. 
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Print Line - A printer pontrol that causes the line containing the 
Active Position to be transmitted to the printer port and the 
print function to be executed. 

Print Page - A printer control that causes the page containing the 
Active Position to be transmitted to the printer port and the 
print function to be executed. The extent of the area which is to 
be transmitted is determined by the setting of Print Extent Mode. 
"Print Page" was previously called "Print Screen" in Level 1 and 
Level 2. Page refers to the logical display as seen by the host, 
and may be larger or smaller than the physical screen. 

Print Screen - A printer control that causes the visible screen 
image to be transmitted to the printer port and the print function 
to be executed. 

Virtual Terminal - Consists of all the context (state information) 
of a real terminal but is able to share physical resources (such 
as the keyboard, display, and comm lines) with other virtual 
terminals. This allows a single physical device to appear as more 
than one terminal to a host computer. 

Session - A connection between a single virtual terminal and a 
host computer. 


7.3 STATE DESCRIPTIONS 

7.3.1 Printer Port Flow Control 

The Printer Port uses two flow control mechanisms: 

1 . XON/XOFF 

2. Data Set Ready (DSR) 


7 . 3 . 1 . 1 XON/XOFF 

When XON/XOFF flow control is enabled, XON and XOFF are 
interpreted as flow control characters and are not buffered in the 
printer port input buffer or transmitted to the host. 

The terminal recognizes XOFF (1/3) as a request from the printer 
device to suspend the transmission of characters. When this 
character is received by the terminal, transmission of all 
characters (other than xON or XOFF) to the printer is suspended. 
When the printer port is in this state, it is said to be in the 
XOFF state. 

The terminal recognizes XON (1/1) as a request from the printer 
device to resume the transmission of characters, if any. when 
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this character is received by the terminal, the XOFF state of the 
printer is cleared and transmission of characters in the printer 
port output buffer is resumed. If the line was not XOFF-ed, this 
character is ignored. 

When Printer To Host Communication is enabled (bidirectional 
printer port only) , the terminal transmits an XOFF to the printer 
device if a character other than XON or XOFF is received from that 
device, and (1) the number of characters in the input buffer 
reaches the first XOFF point for the first time since the last XON 
was sent; (2) the number of characters in the input buffer reaches 
the second XOFF point for the first time since the last XON was 
sent; or (3) the input buffer is full. If the input buffer is 
full, the received character is discarded. 

The terminal transmits an XON to the printer device when the 
printer port input buffer empties to the XON point, and the last 
flow control sent was XOFF. 

When XON/XOFF flow control is disabled at both the printer port 
and the host port, characters XON and XOFF may be sent to the 
printer in Printer Controller mode, and are buffered and 
transmitted to the host when Printer To Host communication is 
enabled. 

PRINTER PORT FLOW CONTROL: (XOFF, NO XOFF); 


7. 3.1.2 Data Set Ready (DSR) 

The terminal polls DSR on the printer port before transmitting 
each character. If DSR is not being asserted by the printer 
device, transmission of the character is suspended until DSR is 
asserted by the printer device. DSR takes precedence over the 
XON/XOFF state. 

All print commands will be ignored unless the terminal has seen 
Data Set Ready (DSR) since the last power-up, or Reset to Initial 
State (RIS). If at any time the printer sets DSR low (for example 
to indicate paper out), printing is suspended. When DSR is again 
set high, printing can resume. 


7. 3. 1.3 Data Terminal Ready (DTR) 

If DTR is not being used for hardware flow control, the terminal 
asserts DTR on the printer port whenever the terminal is turned on 
and not in self-test. 

Conforming Devices may support the use DTR for hardware flow 
control. The following description is intended as a guideline. 



VSRM - Printer Port Extension EL-00070-07 

*** COMPANY CONF - DEC Internal Use Only 28-Apr-1987 


Page 7-8 


When hardware flow control is selected, DTR is asserted any time 
the terminal is not in self-test, and the terminal's printer port 
input buffer is below the first XOFF point. DTR is de-asserted 
when the printer port input buffer is filled up to or beyond the 
first XOFF point. If the input buffer is full, received 
characters are discarded until there is again room in the input 
buffer . 

When hardware flow control is used, only a few characters of 
buffer space are required to prevent loss of data. The first XOFF 
point is suggested as the flow control threshold because it is 
often adjustable allowing the user to tailor the buffer size 
depending the interaction requirements. 


7.3.2 Printer Port Status 

The printer port can be in one of three states depending on 
whether the terminal believes there is a printer available, and 
whether the printer is ready to accept data. The printer port 
status may be determined from the host using a Device Status 
Report control sequence. 

If DSR (Data Set Ready) has not been asserted on the printer port 
since the last power-up or Reset to Initial State (RIS), the 
terminal assumes there is no printer. The device status report 
(response from terminal to host) will indicate "Printer not 
available". In this state, all print commands which require the 
printer port are ignored. 

If the printer port has seen DSR since power-up, but it is no 
longer asserted on the printer port, the device status report will 
indicate "Printer not ready". In this state, print operations 
shall be queued. Updates that would affect the data to be printed 
are suspended until the data has been transferred to the printer 
port. If the terminal's host port input buffer fills, XOFF will 
be sent to the host (if enabled). 

If the printer port sees DSR, the device status report will 
indicate "Printer ready". In this state, print operations can 
proceed immediately. Note updates that would affect the data to 
be printed are still suspended until the data has been transferred 
to the printer port. The printer port may provide an output 
buffer to minimize interruption of display updates. 

PRINTER_STATUS : 

( PRINTER_READY, PRINTER_NOT READY, PRINTER NOT AVAI LABLE ) ; 
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7.3.3 Printer Port Status On Virtual Terminals 

When Virtual Terminals are supported (Session Management 
Extension), the terminal will report two additional printer port 
states to indicate the printer port is in use by another session. 

If the Data Set Ready signal at the printer port is asserted, but 
an alternate session is currently sending information to the 
printer, the device status report will indicate "Printer Busy." 
This is functionally equivalent to the "Printer Not Ready" 
condition above. 

If the printer port is explicitly assigned to another session so 
that the current session may not access the printer port, the 
device status report will indicate "Printer Not Assigned." This is 
functionally equivalent to the "Printer Not Available" condition 
above . 


7.3.4 Printer Port Communications Environment 

The printer port can be set for either an 8-bit or 7-bit 
communications line environment independently of the Host Port. 
In the 7-bit environment, all data will be transmitted as 7-bit 
characters. In the 8-bit environment, each character will be 
transmitted as an 8-bit character. If the host port is set to 
8-bits and the printer port is set to 7-bits, Cl control 
characters will be converted to ESC Fe sequences at the printer 
port, and GR characters will have their eighth bit stripped. 

PRINTER PORT ENVIRONMENT: (EIGHT BIT, SEVEN BIT); 


7.3.5 Printer To Host Communications 

Printer To Host Mode relays all input from the printer port other 
than XON/XOFF flow control back to the host (enabling session). 
Printer To Host mode may be selected from the host using the Media 
Copy (MC) control function. 

Character input from the printer port is interleaved with input 
from the keyboard as it is received. Arbitration between keyboard 
and auxiliary device input is the responsibility of the 
application program and user. The terminal only provides 
arbitration to the keystroke, control function, or character 
level. 

Characters associated with a single keystroke, or control function 
are sent as contiguous bytes. When the terminal sees an ESC, CSI, 
DCS, OSC, PM, or APC character, the escape sequence, control 
sequence, or control string, will be buffered until a terminator 
is received for the sequence, or until the input buffer is full. 
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Notes ; 

1. Printer To Host Mode functions in Printer Controller Mode 
as well as other print modes. 

2. When available. Printer To Host Mode works at all 
operating levels (level 1, level 2, and level 3). 8-bit 
graphic characters may be relayed from the printer port 
even when the conformance level is set to Level 1. 

3. If the host port is set to 7-bits, Cl control characters 
will be converted to ESC Fe sequences at the host port 
before re-transmission to the host, and GR characters 
will have their eighth bit stripped. 

PRINTER TO HOST MODE: (PRINTER TO HOST, NO PRINTER TO HOST); 


7.3.6 Printer Controller Mode 

I When Printer Controller Mode is set, all data received at the host 
I port is transferred directly to the printer port without 
I interpretation by the display terminal. The only exceptions to 
this rule are the communications control characters XON and XOFF 
(DCl and DC3), NUL, and the control sequences which cause the 
terminal to enter and exit this mode. 

XON and XOFF are used by the communications software for flow 
control on the line between the terminal and the host, and 
independently for flow control on the line between the terminal 
and the printer. The terminal must intercept the Media Copy 
control sequences from the host which turn Printer Controller Mode 
on and off, and must execute the sequence which turns Printer 
Controller Mode off. These control sequences are not passed to 
the printer. 

Characters from the keyboard continue to be sent to the host. The 
video display is not updated. When in Printer Controller Mode no 
I local printer functions will work. For example; Print Page does 
not work. 

In going from an 8-bit host port to a 7-bit printer port. Cl 
control characters will be translated to ESC Fe sequences, and GR 
characters will have the eighth bit stripped (i.e., no fallback 
translation will be performed for 8-bit graphic characters in 
Printer Controller Mode). 

I Deviation Note 

1 On VT220, VT240, and VT241, when the host port was 

I configured for a 7-bit environment, and the 
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printer port was configured for 8-bits, the 
terminal would translate 7-bit- Cl controls to 
their 8-bit equivalents. New terminals shall NOT 
perform this translation. 


Printer Controller mode can be selected from the host using the 
Media Copy (MC) control function. 

When Control Representation Mode (CRM) is selected, Printer 
Controller Mode is temporarily disabled. 

Upon exiting from Printer Controller mode, the state of Auto Print 
mode is UNDEFINED. That is, when Printer Controller mode is 
exited. Auto Print Mode may not be in the same state it was when 
Printer Controller Mode was entered. 

PRINTER_CONTROLLER_MODE : ( PRINTER_CONTROLLER_OFF , 

PRINTER_CONTROLLER_ON) ; 

Guideline 

The VT220 sets Auto Print mode off (normal print 
mode) upon exit from Printer Controller mode. 


7. 3.6.1 Printer Controller Mode On Virtual Terminals (guideline) 

If the Printer is "assigned" to another session (virtual 
terminal), attempts to invoke Printer Controller Mode will be 
ignored. This is equivalent to the "Printer not available" state, 
but the Device Status Report will indicate "printer not assigned". 

When the printer assignment is "shared" and the printer is in use 
by another session, this is equivalent to the "printer busy 
state". The next action which would cause data to be transferred 
to the printer will cause this session to wait until the printer 
is available. If the input buffer for this session fills while 
waiting, the terminal will send XOFF (or other flow control) to 
the host. Entering Printer Controller Mode forces the printer to 
appear busy to other sessions. 


7.3.7 Autx) Print Mode 

When Auto Print Mode is set, any Line Feed (LF), Vertical Tab 
(VT), Form Feed (FF) control, or the execution of Auto Wrap if 
this mode is enabled, will cause the active line to be transferred 
from the display to the printer port. The line will be terminated 
by a Carriage Return (CR), followed by the same character that 
initiated the print operation (LF, VT, FF, or LF If Auto Wrap). 
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Auto Print mode can be set or cleared by the host using the Media 
Copy (MC) control function. 

AUTO PRINT MODE: (AUTO PRINT OFF, AUTO PRINT ON) ; 


7. 3.7.1 Auto Print Mode On Virtual Terminals (guideline) 

If the Printer is "assigned" to another session, attempts to set 
Auto Print mode will be ignored. If the printer assignment is 
"shared", and the printer is in use by another session (busy), the 
next action which would cause data to be transferred to the 
printer will cause this session to wait until the printer is 
available. Entering Auto Print Mode forces the printer to appear 
busy to other sessions. 

Although Auto Print Mode can keep the printer "busy" indefinitely, 
it is not "assigned" to the session which invokes Auto Print Mode. 
This is to avoid a race condition in which the host could not 
predict whether a print operation will be queued or ignored. 


7.3.8 Print Form Feed Mode 

I Print Form Feed Mode is used to determine whether a Form Feed (FF) 

I control character shall be transmitted to the printer at the 
I conclusion of each Print Page or Print Screen operation. In the 
set state (Print_FF) a Form Feed shall be sent. In the reset 
state ( No_Pr int_FF ) no Form Feed is sent. 

PRINT FORM FEED MODE: (PRINT FF OFF, PRINT FF ON); 


7.3.9 Print Extent Mode 

Print Extent Mode is used to determine the area of the page to be 
transmitted to the printer when a Print Page operation is 
performed. In the set state ( Complete_Page ) the entire contents 
of the current page is transmitted. In the reset state 
( Scrolling_Region ) only the area of the page between the Top 
Margin and Bottom Margin of the scrolling region (inclusive of the 
margins) is transmitted. 

PRINT EXTENT MODE: (PRINT SCROLLING REGION, PRINT DISPLAY); 


7.3.10 Local Controller Mode (not Mandatory) 


When both Local Mode and Controller Mode are selected, the 
terminal is in "Local Controller Mode^' (Local Mode is only 
selectable by the user under local control). In Local Controller 
Mode, keyboard characters are sent directly to the printer port. 
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Note that in regular Local mode the keyboard is aimed at the 
screen, while in regular Controller mode the keyboard is aimed at 
the host. When "Local Controller Mode" is exited to Printer 
Controller Mode, the characters accumulated in the receive silo 
are transmitted to the printer. When "Local Controller Mode" is 
exited to Local Mode, the terminal just redirects the keyboard 
from the printer port to the screen (and parser). Local echo is 
disabled while in Local Controller Mode. CRM mode is disabled 
when in local controller mode. 

Local Controller mode is used to allow keyboard output to a 
printer. In local controller mode, the setting of printer to host 
mode is ignored and characters received from the printer are 
ignored (except XON and XOFF if XOFF support is enabled). 


7.3.11 Printer Style 

Three Printer Style modes are available to match the range of 
character sets the printer is capable of supporting. These are; 
National Only; National + Line Drawing; and All Characters. These 
modes are described in the next section on TRANSMITTING PRINT 
DATA . 

PRINTER_STYLE; 

(NATIONAL ONLY, NATIONAL PLUS LINE DRAWING, ALL CHARACTERS); 


7.4 TRANSMITTING PRINT DATA 


Each time a print of screen data is requested, three things 
happen. First, the printer is "initialized" to a known or assumed 
character set state, either via assumption, or via designating 
escape sequences and/or locking shift sequences. Next, the 
characters are transmitted. This may require additional 
designating escape sequences and/or shifts. Finally, the 
transmission is ended by putting the printer into a known state. 

Since the host may access the printer during auto-print mode, the 
complete initialization / transmission / closing sequence is used 
for each line printed. 


7. 4. 0.1 Print National Only (7-bit Or 8-bit Printer Port 
Environment ) 


ASSUMPTIONS: This mode is included for backward support of "dumb" 
printers which do not understand designating escape sequences, or 
which do not support any character set other than a National 
Replacement Character Set (NRCS). The terminal and printer have 
already been configured to use the same NRC Set. The terminal 
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determines which NRC Set to use based on the keyboard dialect 
(ASCII is the NRC Set for North America). Refer to the National 
Replacement Character Set section below. 

INITIALIZATION: No escape sequences or shifts are sent. It is 

assumed that the printer is ready to print NRCS characters as GL. 

TRANSMISSION: The characters are sent. No escape sequences or 

shifts are sent. If a character which is not in the selected NRCS 
is encountered, fallback is used. If 8-bits is set, the most 
I significant bit is always zero. Characters with the "invisible" 
I character attribute are transmitted as spaces. All other Display 
j Attributes are ignored. 

CLOSING: No closing sequences are sent. 

I FALLBACK: Characters which have an • NRCS equivalent (have an 
I identical dot matrix representation to an NRCS character) are sent 
I as the NRCS equivalent. Otherwise fallback is used (a single 
unsupported character maps to one or more supported characters). 
Refer to the fallback section and tables later in this chapter. 


7. 4. 0.2 Print National + Line Drawing (7-bit Or 8-bit Printer 
Port Environment) 


I ASSUMPTIONS: The printer supports ASCII, the VTlOO line drawing 
1 set (DEC Special Graphics), the current NRCS (when in national 
1 mode), designating escape sequences for GO and Gl , and LSO/LSl 
1 (SO/SI). It does not support 8-bit controls. The terminal 
I determines which NRCS to use based on the keyboard dialect (ASCII 
I is the NRCS for North America). Refer to the National Replacement 
I Character Set section below. 

1 INITIALIZATION: The printer is initialized to be sure the desired 
I NRCS is designated as GO, and DEC Special Graphics (line drawing) 

1 is designated as Gl . GO is invoked. The sequences sent are: 

I ESC ( B (Designate ASCII to GO, note other NRC Sets 

1 require a different designating sequence) 

ESC ) 0 (Designate DEC Special Graphics to Gl ) 

LSO (Invoke GO to GL) 

I TRANSMISSION: The characters are sent, using LSO and LSI to 

I choose between NRCS and DEC Special Graphics. If a character is 

i in both sets (e.g., uppercase letters), it is sent as NRCS. If a 

1 character is in ASCII but not in the current NRCS, ASCII is 

1 designated as Gl and invoked as needed. The next line drawing 
1 character encountered will cause the DEC Special Graphics set to 
I again be designated as Gl , If a character which is not in the 
current NRCS, ASCII, or DEC Special Graphics set is encountered, 
fallback is used. In an 8-bit environment the most significant 
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bit is always set to zero. 

In this mode the display attributes are also sent. Refer to the 
Display Attributes section below. 

CLOSING: LSO is sent, if necessary. If ASCII was the last set 
designated as G1 , DEC Special Graphics (line drawing) is 
re-designated. This leaves the printer with NRCS as GO, DEC 
Special Graphics as Gl, and GO invoked to GL. 

FALLBACK:' If the character has an equivalent (the same dot matrix 
representation) as a character in either the NRCS, DEC Special 
Graphics, or ASCII sets, then the equivalent is used. Otherwise 
fallback is used (a single unsupported character maps to one or 
more supported characters). Refer to the fallback section and 
tables later in this chapter. 


7. 4. 0.3 Print All Characters (7-bit Printer Port Environment) 


ASSUMPTIONS: The printer supports all the character sets in use 
by the terminal, designating escape sequences for GO, Gl , G2 , G3, 
and character set shifts LSO, LSI, SS2 and SS3. If the User 
Preference Supplemental set (UPSS) extension is used, the printer 
has already been configured with the same UPSS. If a DRCS is 
used, the host has already down line loaded the printer's 
character set(s) to match the video terminal's (in Printer 
Controller Mode, if necessary). Printers with changeable font 
cartridges must support all of the above character sets 
simultaneously. No font selection commands will be used. 


INITIALIZATION: The printer is initialized to correspond with the 
terminal. The character sets currently designated as GO, Gl , G2 , 
and G3 in the terminal are designated as GO, Gl , G2 , and G3 in the 
printer respectively. GO is invoked to GL. The sequences sent 
are : 


ESC ( Dscs 
ESC ) Dscs 
ESC * Dscs 
ESC + Dscs 
LSO 


(Designate a 94 character set as GO) 
(Designate a 94 character set as Gl ) 
(Designate a 94 character set as G2 ) 
(Designate a 94 character set as G3 ) 
(Invoke GO to GL) 


Where "Dscs" consists of zero, on'e, or two intermediate 
characters and a final character for the character set 
being designated. 

If a 96 character set is to be designated, the first 
intermediate character will change as follows: 


ESC - Dscs 
ESC . Dscs 


(Designate a 96 character set as Gl ) 
(Designate a 96 character set as G2 ) 
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ESC / Dscs (Designate a 96 character set as G3 ) 

If one of the character sets is the UPSS, it is designated 
as the UPSS, not the specific character set chosen. 


TRANSMISSION; The characters are sent, using LSO and LSI to 
choose between the character sets in GO and Gl . If a character is 
in the set designated as G2, SS2 is used to temporarily invoke G2 
into GL. If a character is in the set designated as G3, SS3 is 
used to temporarily invoke G3 into GL. If a character from an 
alternate character set is encountered the alternate set is 
designated as G3 and SS3 is used to send it. 

The priority order for sending characters contained in more than 
one set is ASCII, UPSS, DEC Supplemental, ISO Supplemental, DEC 
Technical, and DEC Special Graphics. 

In this mode the display attributes are also sent. Refer to the 
Display Attributes section below. 

CLOSING: LSO is sent, if necessary. If an alternate set was the 
last set designated as G3, G3 is re-designated. This leaves the 
printer with GO invoked as GL; GO, Gl, G2, and G3 the same as the 
terminal. 

FALLBACK: When Print All Characters is selected, fallback is only 
provided for CRM characters. CRM characters do not belong to a 
character set. Refer to the fallback section and-tables later in 
this chapter. 


7. 4. 0.4 Print All Characters (8-bit Printer Port Environment) 


ASSUMPTIONS: The printer supports all the character sets in use 
by the terminal, designating escape sequences for GO, Gl , G2 , G3, 
and character set shifts LSO, LSI, LS2R and LS3R. If the User 
Preference Supplemental Set (UPSS) extension is used, the printer 
has already been configured with the same UPSS. If a DRCS is 
used, the host has already down line loaded the printer's 
character set(s) to match the video terminal's (in Printer 
Controller Mode, if necessary). Printers with changeable font 
cartridges must support all, of the above character sets 
simultaneously. No font selection commands will be used. 

INITIALIZATION: The printer is initialized to correspond with the 
terminal. The character sets currently designated as GO, Gl , G2 , 
and G3 in the terminal are designated as GO, Gl, G2, and G3 in the 
printer respectively. GO is invoked to GL, and G2 is invoked to 
GR. The sequences sent are: 

ESC ( Dscs (Designate a 94 character set as GO) 
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ESC ) Dscs 
ESC * Dscs 
ESC + Dscs 
LSO 
LS2R 


(Designate a 94 chitracter set as Gl ) 
(Designate a 94 character set as G2 ) 
(Designate a 94 character set as G3) 
(Invoke GO to GL) 

(Invoke G2 to GR) 


Where "Dscs" consists of zero, one, or two intermediate 
characters and a final character for the character set 
being designated. 


If a 96 character set is to be designated, the first 
intermediate character will change as follows: 


ESC - Dscs 
ESC . Dscs 
ESC / Dscs 


(Designate a 96 character set as Gl) 
(Designate a 96 character set as G2 ) 
(Designate a 96 character set as G3 ) 


If one of the character sets is the UPSS, it is designated 
as the UPS, not the specific character set chosen. 


TRANSMISSION: The characters are sent using LSO/LSl to choose 
between the character sets in GO and Gl , and LS2R/LS3R to choose 
between the character sets in G2 and G3 . If a character from an 
alternate character set is encountered, the alternate set is 
designated as G3, invoked by LS3R, and then sent. 

The priority order for sending characters contained in more than 
one set is ASCII, UPSS, DEC Supplemental, ISO Supplemental, DEC 
Technical, and DEC Special Graphics. 

In this mode the display attributes are also sent. Refer to the 
Display Attributes section below. 

CLOSING: LSO and LS2R are sent if necessary. If an alternate set 
was the last set designated as G3, G3 is re-designated. This 
leaves the printer with GO invoked as GL and G2 invoke as GR; GO, 
Gl , G2 , and G3 the same as the terminal. 

FALLBACK: When Print All Characters is selected, fallback is only 
provided for CRM characters. CRM characters do not belong to a 
character set. Refer to the fallback section and tables later in 
this chapter. 


Documented Exception 

The "All Characters" mode in the VT200 family 
designated ASCII as GO, Line Drawing as Gl , DEC 
Multinational as G2, and the DRCS as G3 if needed. 
In the VT300 family, possible support for the UPSS 
(8-bit architecture), DEC Technical, and DEC 
Publishing meant VT200 "All Characters" mode 
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really printed multinationa.1 characters. In the 
VT300, "All Characters" mode was changed to print 
all characters more efficiently. Some terminals 
may provide a "Multinational" mode similar to "All 
Characters" on the VT200 to support fallbacks for 
other character sets (DEC Technical for example). 


7.4.1 National Replacement Character Sets 

There are 12 NRC Sets currently defined for 16 keyboard dialects. 
The National Replacement Character set for each keyboard dialect 
is as follows: 


Keyboard Dialect 

NRC Set 



Designating Characters 

North American 

ASCII 



B 

(4/2) 

Flemish 

French NRC Set 



R 

(5/2) 

Canadian (French) 

French Canadian 1 

NRC 

Set 

9 

(3/9) 

British 

U.K. NRC Set 



A 

(4/1) 

Danish 

No rwegi an/Danish 

NRC 

Set 


(6/0) 

Finnish 

Finnish NRC Set 



5 

(3/5) 

Austrian/German 

German NRC Set 



K 

(4/11) 

Dutch 

ASCII 



B 

(4/2) 

Italian 

Italian NRC Set 



Y 

(5/9) 

Swiss (French) 

Swiss NRC Set 



s 

(3/13) 

Swiss (German) 

Swiss NRC Set 



s 

(3/13) 

Swedish 

Swedish NRC Set 



7 

(3/7) 

Norwegian 

Norwegian/Danish 

NRC 

Set 


(6/0) 

Belgian/French 

French NRC Set 



R 

( 5/2 ) 

Spanish 

Spanish NRC Set . 



Z 

(5/10) 

Portuguese 

Portuguese NRC Set 


% 

6 (2/5 3/6) 


The National Replacement Character Sets are available only when 
the appropriate keyboard is selected in the terminal. 

Deviation Note 

VT200 family devices support the Dutch NRC set 
(designating character "4" (3/4)). 

Guideline: LA120 non-conforming sequences: 

Finland "C" (4/3); Sweden "H" (4/8); French 

Canadian "Q" (5/1); Norway/Denmark "6" (3/6) or 

"E" (4/5). 
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I 7.4.2 Display Attributes 

I 

I When the Printer Style is "National + Line Drawing", or "Print All 

I Characters", the display attributes are also sent. The attributes 
are of two kinds: line attributes and character attributes. The 
line attributes will be initialized at the beginning of each line 
as follows: 


Single Width lines - 
Double Width lines - 
Top half of Double Height - 
Bottom half of Double Height - 


ESC # 5 
ESC # 6 
ESC # 3 
ESC # 4 


The character attributes will be initialized at the start of each 
print operation as follows: 

ESC [ 0 m 

Every time the character attributes change, the appropriate 
control sequence setting the character attributes will be sent. 
The sequences are of the form: 

ESC [ 0 ; PS ; Ps ; Ps m 

With the following parameters: 

0 all attributes off 

1 for bold character attribute 

4 for underscore character attribute 

5 for blink character attribute 

7 for reverse video character attribute 

At the end of each print (line or page), the following 
closing sequences will be sent as appropriate: 

ESC [ 0 m 

Note: characters with the "invisible" character attribute ( SGR 

parameter 8) are always sent to the printer as spaces. 


7.4.3 Trailing Spaces 

Trailing spaces are spaces which come after all printable 
characters on a line. Note that in general trailing spaces 
themselves are not printed. In "National Only" trailing spaces 
are not printable and therefore are not sent to the printer. In 
"National + Line Drawing" and "All Characters" some spaces have 
video character attributes, and are therefore printable. In this 
context, spaces with the normal video character attribute which 
follow all printable characters (including spaces with video 
attributes on), are not sent to the printer. 



VSRM - Printer Port Extension EL-00070-07 Page 7-20 

*** COMPANY CONF - DEC Internal Use Only 28-Apr-1987 


7.5 FALLBACK PRESENTATION OF GRAPHIC CHARACTERS 

When the Printer Style specifies that the device attached to the 
Printer Port is not capable of presenting graphic characters which 
can be presented on the terminal, the terminal attempts to display 
a reasonable approximation of that character on the printer for 
the Printer Port function operations, and in. Auto-Print mode. 
These approximations, or "Fallbacks", are not necessarily unique 
but are intended to allow the reader of the result to be able to 
reconstruct the original text using context to resolve conflicts. 

NOTE 

These fallbacks are not performed in Printer 
Controller Mode or in Printer to Host operations. 


7.5.1 NRC Fallbacks 

No NRC fallbacks are required. There are no NRCS characters which 
are not in DEC Multinational or ISO Latin Alphabet Nr 1 (see the 
corresponding fallback sections). 

Deviation Note 

In older devices, two National Replacement 
Characters in the Dutch NRC set are not available 
in DEC-MCS, or ISO Latin-1. If the Printer Style 
is set to National Only or National + Line 
Drawing, and one of these characters occur in the 
data stream and. is not available in the current 
national set, fallback is used as described below. 

Character Fallback Presentation 

ij ij vowel (Dutch NRCs 5/11) ij 

florin florin (Dutch NRCs 7/12) f 


7.5.2 DEC Special Graphics Fallbacks 

If the Printer Style is set to "Print National Only", the terminal 
will represent all characters from the DEC Special Graphic (VTlOO 
Line Drawing) character set as one or two character sequences from 
the ASCII character set which approximate the desired graphic. 
These characters have been chosen so that diagrams or 
presentations that use the mosaic line combinations will align 
properly and present a reasonable appearance. 
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Character 

Fallback Presentation 

<★*> 

diamond 


★ 

<##> 

filled block 


# 

<HT> 

HT symbol 


HT 

<FF> 

FF symbol 


FF 

<CR> 

CR symbol 


CR 

<LF> 

LF symbol 


LF 

<+-> 

plus/minus sign 


+ 

<0"> 

degree sign 


0 

<NL> 

NL symbol 


NL 

<VT> 

VT symbol 


VT 

<_l> 

lower right corner 


+ 

<-|> 

upper right corner 


+ 

<r> 

upper left corner 



<i_> 

lower left corner 


+ 

<+> 

intersection 


+ 


scan 1 



<"-> 

scan 3 



< — > 

scan 5 


- 

<- > 

scan 7 


» 

< > 

scan 9 



<i-> 

intersect from right 



<-i> 

intersect from left 


-1" 

< L> 

intersect from top 


+ 

<T> 

intersect from bottom 


+ 

<l> 

vertical bar 


1 

<<-> 

less than or equal to 


<» 

V 

II 

V 

greater than or equal to 


>* 

<][> 

Pi symbol 


Pi 

</=> 

not-equal to 


<> 

<L=> 

pound sign 


# 


centered dot 


• 

7.5.3 

DEC Supplemental Fallbacks 



If the 

Printer Style is set to "Print National Only", or "Print 

National + Line Drawing" the 

terminal will 

represent all 

characters from the DEC Supplemental 

character set 

as a sequence 


of one or more characters from the ASCII character set which 
approximate the desired graphic as described in the fallback table 
below. 
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Character 


Fallback Presentation 

<! I> 

SP03 

inverted exclamation mark 

1 

• 

<c/> 

SC04 

cent sign 

c 

<L*> 

SC02 

pound sign 

# 

<Y=> 

SC05 

yen sign 

Y 

<So> 

SM24 

section 

sign 

Sc 

<Xo> 

SCOl 

general 

currency sign 

0 

<co> 

SM52 

copyright sign 

(C) 

< a> 

SM21 

feminine ordinal 

a 

<<<> 

SP17 

angle quotation mark left 

<< 

<0"> 

SM19 

degree : 

sign 

0 

<+-> 

SAG 2 

plus/minus sign 

+ 

<2"> 

NS02 

superscript 2 

2 

<3"> 

NS03 

superscript 3 

3 

</u> 

SMI 7 

micro sign 

u 

<IP> 

SM25 

paragraph sign 

Pr 

< • ^> 

SM26 

middle ( 

dot 

• 

<1"> 

NSOl 

superscript 1 

1 

< o> 

SM20 

masculine ordinal 

o 

<>>> 

SP18 

angle quotation mark right 

>> 

<14> 

NF04 

fraction one quarter 

1/4 

<12> 

NFOl 

fraction one half 

1/2 

<??> 

SP16 

inverted question mark 

? 

<a' > 

LAll 

small a 

with acute accent 

a 

<A' > 

LA12 

capital 

A with acute accent 

A 

<a' > 

LA13 

small a 

with grave accent 

a 

<A' > 

LAI 4 

capital 

A with grave accent 

A 

<a"> 

LA15 

small a 

with circumflex 

a 

<A^> 

LA16 

capital 

A with circumflex 

A 

<a”> 

LAI 7 

small a 

with dieresis or umlaut 

a 

<A”> 

LAI 8 

capital 

A with dieresis or umlaut 

A 

<a"'> 

LAI 9 

small a 

with tilde 

a 

<A'"> 

LA20 

capital 

A with tilde 

A 

<a*> 

LA27 

small a 

with ring 

a 

<A*> 

LA28 

capital 

A with ring 

A 

<ae> 

LA51 

small ae diphthong 

ae 

<AE> 

LAS 2 

capital 

AE diphthong 

AE 

<c, > 

LC41 

small c 

with cedilla 

C 

<C, > 

LC42 

capital 

C with cedilla 

C 

<e ' > 

LEI I 

small e 

with acute accent 

e 

<E' > 

LE12 

capital 

E with acute accent 

E 

<e' > 

LE13 

small e 

with grave accent 

e 

<E' > 

LE14 

capital 

E with grave accent 

E 

<e"> 

LE15 

small e 

with circumflex 

e 

<E^> 

LE16 

capital 

E with circumflex 

E 

<e”> 

LE17 

small e 

with dieresis or umlaut 

e 

<E"> 

LE18 

capital 

E with dieresis or umlaut 

E 

<i'> 

LIll 

small i 

with acute accent 

i 

<I'> 

LI12 

capital 

I with acute accent 

I 

<i ' > 

LI13 

small i 

with grave accent 

i 

<I^> 

LI14 

capital 

I with grave accent 

I 

<i''> 

LI15 

small i 

with circumflex 

i 


-22 
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<!"'> LI16 capital I with circumflex I 

<i"> LI17 small i with dieresis i 

<I"> LI18 capital I with dieresis I 

<n~> LNll small n with tilde n 

<N~> LN12 capital N with tilde N 

<o'> LOll small o with acute accent o 

< 0 '> L012 capital 0 with acute accent 0 

<o'> L013 small o with grave accent o 

<0'> L014 capital 0 with grave accent 0 

<o"> LOIS small o with circumflex o 

<0^> L016 capital 0 with circumflex 0 

<o"> L017 small o with dieresis or umlaut mark o 

<0"> L018 capital 0 with dieresis or umlaut mark 0 

<o~> L019 small o with tilde o 

<0~> LO20 capital 0 with tilde 0 

<oe> L051 small oe ligature oe 

<OE> L052 capital OE ligature OE 

<o/> L061 small o with slash o 

<0/> L062 capital 0 with slash 0 

<ss> LS61 German small sharp s ss 

<u'> Lull small u with acute accent u 

<U'> LU12 capital U with acute accent U 

<u’> LU13 small u with grave u 

<U'> LU14 capital U with grave U 

<u"> LUIS small u with circumflex u 

<U'> LU16 capital U with circumflex U 

<u"> LU17 small u with dieresis or umlaut u 

<U"> LU17 capital U with dieresis or umlaut U 

<y"> LY17 small y with dieresis y 

<Y"> LY18 capital Y with dieresis Y 


7.S.4 ISO Latin-1 Supplemental Fallbacks 

If the Printer Style is set to "Print National Only", or "Print 
National + Line Drawing", the terminal will represent all 
characters from the ISO Latin-1 supplemental character set as a 
sequence of one or more characters from the ASCII character set 
which approximate the desired graphic as described in the fallback 
table below. 
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Character 

Fallback .Presentation 

<NBSP> 

SP?? 

no break space 

<space> 

<i l> 

SP03 

inverted exclamation mark 

1 

<c/> 

SC04 

cent sign 

c 

<L*> 

SC02 

pound sign 

# 

<Xo> 

SCOl 

general currency sign 

0 

<Y*> 

SC05 

yen sign 

Y 

<1 1> 

SM?? 

broken bar 

1 

<So> 

SM24 

section sign 

Sc 


SCOl 

diaeresis 

ft 

<co> 

SM52 

copyright sign 

(C) 

< a> 

SM21 

feminine ordinal 

a 

<<<> 

SP17 

angle quotation mark left 

<< 

<-,> 

SM?? 

logical not sign 

(tilde) 

<SHY> 

SM18 

soft hyphen 

- (dash) 

<RO> 

SM53 

registered trade mark sign 

(R) 


SP31 

macron, overline 

- (dash) 

o 

> 

V 

SM19 

degree sign 

o 

<4— > 

SA02 

plus/minus sign 

+ 

<2"> 

NS02 

superscript 2 

2 

<3"> 

NS03 

superscript 3 

3 


soil 

acute accent 

' (apostrophe) 

</u> 

SM17 

micro sign 

u 

< IP> 

SM25 

paragraph sign 

Pr 

< . "> 

SM26 

middle dot 

• 

< # f > 

SD41 

cedilla 

, (comma) 

A. 

> 

V 

NSOl 

superscript 1 

1 

< o> 

SM20 

masculine ordinal 

o 

<>>> 

SP18 

angle quotation mark right 

>> 

<14> 

NF04 

fraction one quarter 

1/4 

<12> 

NFOl 

fraction one half 

1/2 

<34> 

NF05 

fraction three quarters 

3/4 

<??> 

SP16 

inverted question mark 

? 

<A' > 

LAI 4 

capital A with grave accent 

A 

<A'> 

LA12 

capital A with acute accent 

A 

<A''> 

LA16 

capital A with circumflex 

A 

<A"> 

LA18 

capital A with diaeresis or umlaut 

A 

<A'^> 

LA20 

capital A with tilde 

A 

<A*> 

LA28 

capital A with ring 

A 

<AE> 

LAS 2 

capital AE diphthong 

AE 

<C, > 

LC42 

capital C with cedilla 

C 

<E' > 

LE14 

capital E with grave accent 

E 

<E'> 

LE12 

capital E with acute accent 

E 

<E"> 

LE16 

capital E with circumflex ’ 

E 

<E**> 

LE18 

capital E with diaeresis or umlaut 

E 

<I '> 

LI14 

capital I with grave accent 

I 

<I'> 

LI12 

capital I with acute accent 

I 

<I^> 

LI16 

capital I with circumflex 

I 

<I"> 

LI18 

capital I with diaeresis 

I 

<-D> 

LD62 

capital Icelandic letter Eth 

D 

<N'^> 

LN12 

capital N with tilde 

N 

<0' > 

L014 

capital 0 with grave accent 

0 


24 
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<0'> 

L012 

capital 

0 with acute accent 

0 

<0"> 

L016 

capital 

0 with circumflex 

0 

<0'"> 

LO20 

capital 

0 with tilde 

0 

<0”> 

<xx> 

L018 

capital 0 with diaeresis or uplaut 
times sign 

0 

X 

<0/> 

L062 

capital 

0 with slash 

0 

<U'> 

LU14 

capital 

U with grave 

u 

<U' > 

LU12 

capital 

U with acute accent 

u 

<u"> 

LU16 

capital 

U with circumflex 

u 

<U”> 

LU17 

capital 

U with diaeresis or umlaut 

u 

<Y'> 

LY12 

capital 

y with acute accent 

Y 

<TH> 

LT64 

capital 

Icelandic letter Thorn 

Th 

<SS> 

LS61 

German small sharp s 

SS 

<a'> 

LA13 

small a 

with grave accent 

a 

<a' > 

LAll 

small a 

with acute accent 

a 

<a^> 

LAI 5 

small a 

with circumflex 

a 

<a'"> 

LAI 9 

small a 

with tilde 

a 

<a”> 

LA17 

small a 

with diaeresis or umlaut 

a 

<ae> 

LA51 

small ae diphthong 

ae 

<a*> 

LA27 

small a 

with ring 

a 

A 

O 

V 

LC41 

small c 

with cedilla 

c 

<e' > 

LE13 

small e 

with grave accent 

e 

<e' > 

LEll 

small e 

with acute accent 

e 

<e"> 

LE15 

small e 

with circumflex 

e 

<e"> 

LE17 

small e 

with diaeresis or umlaut 

e 

<i ' > 

LI13 

small i 

with grave accent 

i 

<i ' > 

LIll 

small i 

with acute accent 

i 

<i^> 

LI15 

small i 

with circumflex 

i 

<i”> 

LI17 

small i 

with diaeresis 

i 

<-d> 

LD63 

small Icelandic letter Eth 

d 

<n"> 

LNll 

small n 

with tilde 

n 

<o' > 

L013 

small o 

with grave accent 

o 

<o' > 

LOll 

small o 

with acute accent 

o 

<o^> 

L015 

small 0 

with circumflex 

o 

<o"> 

L019 

small o 

with tilde 

o 

<o”> 
<-: > 

L017 

small o with diaeresis or umlaut 
division sign 

o 

<o/> 

L061 

small o 

with slash 

o 

<u' > 

LU13 

small u 

with grave 

u 

<u' > 

Lull 

small u 

with acute accent 

u 

<u"> 

LU15 

small u 

with circumflex 

u 

<u”> 

LU17 

small u 

with diaeresis or umlaut 

u 

<y' > 

LYll 

small y 

with acute accent 

y 

<th> 

LT63 

small Icelandic letter Thorn 

th 

<y”> 

LY17 

small y 

with diaeresis 

y 


7.5.5 DEC Technical Character Set Fallbacks 

If the Printer Style is set to anything other than "Print All 
Characters", the terminal will represent all characters from a ROM 
resident (not DECS) DEC Technical Character set as one or two 
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character sequences from the ASCII character set which approximate 
the desired graphic. These characters have been chosen so that 
diagrams or presentations that use the mosaic line combinations 
will approximately represent the displayed characters and present 
a reasonable appearance. 


Character 


Fallback Presentation 


<-v> 

<|-> 
<Horiz> 
<Topl> 
<BotI> 
<Vert> 
line ) 
<Topi > 
<Bot [ > 
<Top] > 
<Bot]> 
<Top( > 
<Bot(> 
<Top) > 
<Bot ) > 
<{{> 
<}}> 
<TopS> 
<BotS> 
<\\> 
<//> 
<TopRS> 
<BotRS> 
<>S> 

<< = > 

<*/> 

<>=■> 

< Integ> 
<: . > 
<var > 
<o0> 

<-: > 

<DELTA> 

<nabla> 

<PHI> 

<GAMMA> 

< > 

<~-> 

<THETA> 

<xx> 

<LAMBD> 

<< = >> 

< = >> 
<=-> 


left radical 
top left radical 
horizontal connector 
top integral 
Bottom integral 
vertical connector 

top left square bracket 

bottom left square bracket 

top right square bracket 

bottom right square bracket 

top left parenthesis 

bottom left parenthesis 

top right parenthesis 

bottom right parenthesis 

left middle curly brace 

right middle curly brace 

top left summation 

bottom left summation 

top vertical summation connector 

bottom vertical summation connector 

top right summation 

bottom right summation 

right middle summation 

less than or equal 

not equal 

greater than or equal 

integral 

therefore 

variation, proportional to 
infinity 

division, divided by 
capital delta, triangle 
nabla, del 
capital phi 
capital gamma 
is approximate to 
similar or equal to 
capital theta 
times, cross product 
capital lambda 
if and only if 
implies 

is identical to 


-V 


( 

) 


[ 

[ 

] 

] 

( 

( 

) 

) 

{ 

} 

> 

< 

\ (backslash) 

/ (slash) 
none 
none 
> 

< 

> 

s 

: . ( colon , per iod ) 
a 

oO 

D 

V 

F 

G 

~ (tilde) 

" (tilde) 

J 

X 

L 

< = > 

= > 


(minus) 

(vertical 



•\) nJ •yJ •\) •yJ 
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<PI> 

capital pi, product 

P 

<PSI> 

capital psi 

Q 

<SIGMA> 

capital sigma, summation 

s 

<Rad> 

radical 


<OMEGA> 

capital omega. Ohm sign 

w 

<XI> 

capital xi 

X 

<UPSIL> 

capital upsilon 

Y 

<cc> 

is included in 

C 

<inclu> 

includes 

none 

<inter> 

intersection 

(circumflex) 

<union> 

union 

V 

<L&> 

logical and 

& (ampersand) 

<L 1 > 
line ) 

logical or 

1 (vertical 

<L~> 

logical not 

~ (tilde) 

<alpha> 

small alpha 

a 

<beta> 

small beta 

b 

<chi> 

small chi 

c 

<delta> 

small delta 

d 

<epsil> 

small epsilon 

e 

<phi> 

small phi 

f 

< gamma > 

small gamma 

g 

<eta> 

small eta 

h 

<iota> 

small iota 

i 

<theta> 

small theta 

j 

<kappa> 

small kappa 

k 

<lambd> 

small lambda 

1 

<nu> 

small nu 

n 

<pd> 

partial derivative 

none 

<pi > 

small pi 

P 

<psi> 

small psi 

q 

< rho> 

small rho 

r 

<sigma> 

small sigma 

s 

<tau> 

small tau 

t 

<func> 

function 

f 

<omega> 

small omega 

w 

<xi> 

small xi 

X 

<upsil> 

small upsilon 

y 

<zeta> 

small zeta 

z 

<<-> 

left arrow 

<- 

<'|> 

up arrow 


A 

1 

V 

V 

right arrow 

-> 

<v 1 > 

down arrow v 

NOTE 

Wherever the word "none" appears in the above 
chart, the fallback of last resort, the SPACE 
character, shall be sent to the printer port as 


? the fallback presentation for that character. 


27 
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7.5.6 DRCS Fallbacks 

If the Printer Style is set to anything other than "Print All 
Characters", the SPACE character (2/0) is printed in place of any 
character from a DRCS, except when the designating string of the 
DRCS matches a ROM-based character set that may be printed. If 
the DRCS is substituting for a ROM-based character set, the 
appropriate character from the ROM-based character set is used (if 
it can be printed without fallback). 

Deviation Note 

The printer fallback character on the VT200 series 
was the underscore ("_"). This was changed to 
space to simplify manual editing of documents 
containing fallback characters. 


7.5.7 User Preference Supplemental Set Fallbacks 

The terminal must know the User Preference Supplemental Set even 
though the host may not. If the UPSS is DEC or ISO Supplemental, 
the terminal will use the corresponding fallback table previously 
given. UPSS fallback is only used when the Printer Port is set to 
Print National Only, or Print National + Line Drawing. 


7.5.8 Control Representation Mode Fallbacks (not Mandatory) 

Control Representation characters are presented to the printer as 
a pair of capital ASCII letters or digits representing the name of 
the CO or Cl control character. If the printer supports the 
underscore graphic rendition and "Print National + Line Drawing", 
or "Print All Characters" is selected, the CRM fallback 
combinations, are also underlined to distinguish them from normal 
text . 


Control Character 


Fallback Presentation 


0/0 

Null 

NU 

0/1 

Start of Header 

SH 

0/2 

Start Transmission 

SX 

0/3 

End of Text 

EX 

0/4 

End of Transmission 

. ET 

0/5 

Enqui ry 

EQ 

0/6 

Acknowledge 

AK 

0/7 

Bell 

BL 

0/8 

Backspace 

BS 

0/9 

Horizontal Tab 

HT 

0/10 

Line Feed 

LF 

0/11 

Vertical Tab 

VT 
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0/12 Form Feed FF 
0/13 Carriage Return CR 
0/14 Shift Out (Locking Shift 1) SO 
0/15 Shift In (Locking Shift 0) SI 
1/0 Data Link Escape DL 
1/1 Device Control 1 Dl 
1/2 Device Control 2 D2 
1/3 Device Control 3 D3 
1/4 Device Control 4 , D4 
1/5 Negative Acknowledge NK 
1/6 Synchronous Idle SY 
1/7 End of Transmission Block EB 
1/8 Cancel CN 
1/9 End of Medium EM 
1/10 Substitute SB 
1/11 , Escape EC 
1/12 File Separator FS 
1/13 Group Separator GS 
1/14 Record Separator RS 
1/15 Unit Separator US 
8/0 80 
8/1 81 
8/2 82 
8/3 83 
8/4 Index IN 
8/5 Next Line NL 
8/6 Start of Selected Area SS 
8/7 End of Selected Area ES 
8/8 Horizontal Tabulation Set HS 
8/9 Horizontal Tab with Justification HJ 
8/10 Vertical Tabulation Set VS 
8/11 Partial Line Down PD 
8/12 Partial Line Up PU 
8/13 Reverse Index RI 
8/14 Single Shift 2 S2 
8/15 Single Shift 3 S3 
9/0 Device Control String DC 
9/1 Private Use 1 Pi 
9/2 Private Use 2 P2 
9/3 Set Transmit State SE 
9/4 Cancel Character CC 
9/5 Message Waiting MW 
9/6 Start of Protected Area SP 
9/7 End of Protected Area EP 
9/8 98 
9/9 99 
9/10 9 A 
9/11 Control Sequence Introducer CS 
9/12 String Terminator ST 
9/13 Operating System Command OS 
9/14 Privacy Message PM 
9/15 Application Program Command AP 
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7.6 PRINT OPERATIONS 

7.6.1 Print Page Or Scrolling Region 

The text for the current page of the current session or just the 
lines in the current page which are in the active scrolling region 
are transferred to the printer. Which occurs depends on the 
setting of Printer Extent Mode (DECPEX). This function is invoked 
by the host through the Media Copy (MC) control function, or by 
the user pressing the LOCAL PRINT key. 


7.6.2 Print Screen (not Mandatory) 

A series of characters representing the composed image on the Main 
Display is transferred to the printer. The intent of this 
operation is to reproduce the contents of the screen as if a 
snapshot had been taken. Due to various terminal and printer 
limitations, some compromises may be necessary for complex 
displays. The Main Display may consist of information from more 
than one Session depending on the User Window configuration. 

This function is not affected by Printer Extent Mode (DECPEX). 
Print Screen is invoked by the host through the Media Copy (MC) 
control function, or by the user pressing the SHIFT key and LOCAL 
PRINT key together. 

Guidelines: 

If the Sixel Graphics Extension is present and graphics printing 
is enabled, the contents of the screen (both text and graphics) 
may be transmitted as sixels. 

If graphics printing is not used, borders on the Main Display may 
be transmitted to the Printer Port as characters from the DEC 
Special Graphics character set. 


7.6.3 Print All Pages (guideline) 

The text from all pages in the active session is transferred to 
the printer. The setting of Printer Extent Mode (DECPEX) affects 
this function. If Print Form Feed (DECPFF) mode is set, a form 
feed (FF) character will be transmitted at each page boundary. 
The pages are transmitted in numerical order starting with page 
one. This function is invoked by the host through the Media Copy 
(MC) control function. 
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I 7.6.4 Print Line 

I The text of the line on which the output cursor resides is 
I transferred to the printer. Whether the left and right scrolling 
I regions (set through DECSLRM) affect which characters are sent to 
I the Printer Port depends on the setting of Printer Extent Mode 
I (DECPEX). This function is invoked by the host through the Media 
I Copy (MC) control function. 
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7.7 CONTROL FUNCTIONS 

REPORT PRINTER STATUS DSR 


I Levels: IX, 2X, 3X 


Purpose: Report the 

status of 

the 

printer 

Request Format: CSI 

? 

15 

n 

9/11 

3/15 

3/1 

3/5 6/14 

Report Format: CSI 

? 

Ps 

n 

9/11 

3/15 

Ps 

6/14 


Description: The terminal will respond to a DSR request by 

transmitting a Device Status Report control sequence containing 
one of the following selective parameters (preceded by the 
private parameter value ?, 3/15): 


Selective 

Parameter 


Meaning 


10 The printer is ready to print. The Data Set 

Ready signal is asserted at the printer port. 

11 The printer is not ready to print. The 

Data Set Ready signal at the printer port 
was previously asserted (since power on), 
but is not asserted now. 

13 The printer is not connected to the terminal. 

The Data Set Ready signal at the printer port 
has not been on since the last power-up or 
reset ( RIS ) . 

Printer Status on Virtual Terminals 

(Session Management Extension Only) 

18 The printer is busy. The Data Set Ready signal 

at the printer port is asserted, but an alternate 
session is currently sending information to the 
printer, has the printer in auto-print mode, or 
has the printer in printer controller mode. 

19 The printer is not assigned to the requesting session. 

The current session may not access the printer port 
(regardless of Data Set Ready) because the user has 
explicitly assigned it to another session. 


Notes : 



VSRM - Printer Port Extension EL-00070-07 

*** COMPANY CONF - DEC Internal Use Only 28-Apr-1987 


Page 7-33 


1. See the section State Descriptions - Printer Status for a 
complete description of how the status of the printer is 
maintained . 

State Affected; None 


Algorithm: 


PROCEDURE REPORT_PRINTER_STATUS; 

BEGIN 

CASE PRINTER STATUS OF 

PORT, 
PORT, 
PORT, 
PORT, 
PORT, 

END; 

END; 


PRINTER_READY 
PRINTER_NOT_READY 
PRINTER_NO_PRESENT 
PRINTER_BUSY 
PRINTER NOT ASSIGN 


WRITE (HOST 
WRITE (HOST" 
WRITE (HOST" 
WRITE (host" 
WRITE (host" 


' <CSI>?10n' ) 
' <CSI>?lln' ) 
' <CSI>?13n' ) 
'<CSI>?18n' ) 
' <CSI>?19n' ) 


Known Deviations 


None 
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SET/RESET PRINTER CONTROLLER MODE MC 


I Levels: IX, 2X, 3X 

Purpose: To set or reset the state of Printer Controller Mode. 


Set Format: CSI 5 i 

9/11 3/5 6/9 

Reset Format: CSI 4 i 

9/11 3/4 ■ 6/9 


Description; When Printer Controller Mode is set, all data 
received by the terminal is transmitted to the printer port 
without being displayed on the screen. 

Notes: 

1. When Printer Controller Mode is set, the state of Auto 
Print Mode becomes UNDEFINED. That is, when Printer 
Controller Mode is exited. Auto Print Mode may not be in 
the same state as it was when Printer Controller Mode was 
entered . 

State Affected: 

PRINTER_CONTROLLER_MODE : 

( PRINTER_CONTROLLER_OFF , PRINTER_CONTROLLER_ON ) ; 

Algorithm: 

PROCEDURE SET_PRINTER_CONTROLLER_MODE ; 

BEGIN 

PRINTER_CONTROLLER_MODE : = PRINTER_CONTROLLER_ON ; 

END ; 

PROCEDURE RESET_PRINTER_CONTROLLER_MODE ; 

BEGIN 

PRINTER_CONTROLLER_MODE : - PRINTER_CONTROLLER_OFF ; 

AUTO_PRINT_MODE; - AUTO_PRINT_OFF ; 

END; 

Known Deviations: None 
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SET/RESET AUTO PRINT MODE MC 


I Levels IX, 2X, 3X 

Purpose: To set or reset the state of Auto Print Mode. 

Set Format: CSI ? 5 i 

9/11 3/15 3/5 6/9 

Reset Format: CSI ? 4 i 

9/11 3/15 3/5 6/9 

Description: When Auto Print Mode is set, the contents of the 

Active Line is transmitted to the printer port whenever the Active 
Position is advanced to the next line as a result of one of the 
following conditions: 

1. Receipt of a Line Feed (LF), Vertical Tab (VT), or Form 
Feed (FF) control character. 

2. When the Last Column Flag is set and a graphic character 
is received. 

Notes : 

1. When Printer Controller Mode is set, the state of Auto 
Print Mode becomes UNDEFINED. That is, when Printer 
Controller Mode is exited. Auto Print Mode may not be in 
the same state as it was when Printer Controller Mode was 
entered. 

State Affected: 

AUTO_PRINT_MODE: ( AUTO_PRINT_OFF , AUTO_PRINT_ON ) ; 

Algorithm: 

PROCEDURE SET_AUTO_PRINT_MODE; 

BEGIN 

AUTO_PRINT_MODE:= AUTO_PRINT_ON ; 

END; 

PROCEDURE RESET_AUTO_PRINT_MODE ; 

BEGIN 

AUTO_PRINT_MODE : = AUTO_PRINT_OFF ; 

END; 


Known Deviations: None 
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SET/RESET PRINTER TO HOST MODE 


MC 


Levels IX, 2X, 3X 


Purpose; To set or reset the 
Set Format; CSI ? 

9/11 3/15 

Reset Format; CSI ? 


state of Printer To Host Mode. 
9 i 

3/9 6/9 

8 i 


9/11 3/15 3/8 6/9 

Description; When Printer To Host Mode is set, all input from the 
printer port (other than XON/XOFF flow control when enabled) is 
relayed to the host. Character input from the printer port 
is interleaved with input from the keyboard as it is received. 


Notes ; 

1. Printer To Host Mode functions in Printer Controller 
Mode as well as other print modes. 

2. When available. Printer To Host Mode works at all 
operating levels (Level 1, Level 2, and Level 3). 


State Affected; 

PRINTER_TO_HOST_MODE; ( PRINTER_TO_HOST , NO_PRINTER_TO_HOST ) ; 
Algorithm; 

PROCEDURE SET_PRINTER_TO_HOST_MODE ; 

BEGIN 

PRINTER_TO_HOST_MODE ;= PRINTER_TO_HOST ; 

END; 

PROCEDURE RESET_PRINTER_TO_HOST_MODE ; 

BEGIN 

PRINTER_TO_HOST_MODE ;= NO_PRINTER_TO_HOST ; 

END ; 


Known Deviations; None 
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SET/RESET PRINT FORM FEED MODE DECPFF 


I Levels; IX, 2X, 3X 

Purpose: To set or reset the state of Print Form Feed Mode. 

Set Format: CSI ? 18 h 

9/11 3/15 3/1 3/8 6/8 

Reset Format: CSI ? 18 1 

9/11 3/15 3/1 3/8 6/12 

Description: When Print Form Feed Mode is set, a Form Feed (FF) 

control character is transmitted to the printer port at the 
I conclusion of each Print Page or Print Screen operation. 

State Affected; 

PRINT_FORM_FEED_MODE ; ( PRINT_FF_OFF , PRINT_FF_ON ) ; 

Algorithm: 

PROCEDURE SET_PRINT_FORM_FEED_MODE ; 

BEGIN 

PRINT_FORM_FEED_MODE:- PRINT_FF_ON; 

END ; 

PROCEDURE RESET_PRINT_FORM_FEED_MODE ; 

BEGIN 

PRINT_FORM_FEED_MODE : = PRINT_FF_OFF ; 

END; 

Known Deviations: None 



I VSRM - Printer Port Extension EL-00070-07 Page 7-38 

I *** COMPANY CONF - DEC Internal Use Only 28-Apr-1987 


SET/RESET PRINT EXTENT MODE DECPEX 


I Levels: IX, 2X, 3X 

Purpose: To set or reset the state of Print Extent Mode. 

Set Format: CSI ? 19 h 

9/11 3/15 3/1 3/9 6/8 

Reset Format: CSI ? 19 1 

9/11 3/15 3/1 3/9 6/12 

Description: Print Extent Mode is used to select the area of 

the display to be transmitted to the printer port when a Print 
Page operation is performed. When this mode is in the state 
(Print Display) the entire display image is transmitted. When it 
is in the reset state (Print Scrolling Region), only the area of 
the display within the scrolling region (Top Margin to 
Bottom Margin inclusive) is transmitted. 

State Affected: 

PRINT_EXTENT_MODE : 

( PRINT_SCROLLING_REGION,PRINT_DISPLAY) ; 

Algorithm: 

PROCEDURE SET_PRINT_EXTENT_MODE ; 

BEGIN 

PRINT_EXTENT_MODE : = PRINT_DISPLAY ; 

END ; 

PROCEDURE RESET_PRINT_EXTENT_MODE; 

BEGIN 

PRINT_EXTENT_MODE:= PRINT_SCROLLING_REGION; 

END; 

Known Deviations: None 
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I PRINT PAGE MC 


I Levels IX, 2X, 3X 

I 

I Purpose: Transmit the current page to the printer port. 

Format: CSI 0 i default Ps: 0 

9/11 3/0 6/9 

I Description: The Print Page function causes the text for the 
I current page of the current session or just the lines in the 
I current page which are in the active scrolling region to be 
I transferred to the printer, which occurs depends on the setting 
I of Printer Extent Mode (DECPEX). 

Notes: 


1. Transmission of the text stream includes all necessary 
character set and graphic rendition controls as well as 
format effectors to properly represent the position of 
text on the page. 

State Affected: None 

Algorithm: 

PROCEDURE PRINT_PAGE; 

VAR Y, TOP, BOTTOM: LINE_TYPE; 

X: COLUMN_TYPE; 

P_END_OF_LINE: INTEGER; 

P_L I NE_REND I T I ON : LI NE_REND I TI ON_Ty P E ; 

P_RENDITION: CHARACTER_RENDITION_TYPE ; 

P_GL_CHARACTER_SET: GRAPHICS_CHARACTER_SET_TYPE ; 
P_GR_CHARACTER_SET: GRAPHICS_CHARACTER_SET_TYPE ; 
P_CURRENT_NRCS : GRAPHICS_CHARACTER_SET_TYPE ; 

P_G1_DESIGNATE: GRAPHICS_CHARACTER_SET_TYPE ; 

BEGIN 

(* determine print extent *) 

IF PRINT_EXTENT_MODE = PRINT_DI SPLAY THEN 
BEGIN 
TOP:* 1; 

BOTTOM;* MAX_NUM_LINES ; 

END; 

ELSE 

BEGIN 

TOP:* TOP_MARGIN; 

BOTTOM;* BOTTOM_MARGIN ; 

END; 

(* determine current National character set *) 

P^CURRENT_NRCS : = ASCII_G; 

IF (CHARACTER SET MODE * SEVEN BITS) AND 
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( KEYBOARD_USAGE_MODE = TYPEWRITER) THEN 
P_CURRENT_NRCS : = NRCS_TABLE ( KEYBOARD_DIALECT ) ; 

(* handle each printer style separately *) 

IF PRINTER_STYLE » NATIONAL_ONLY THEN 
BEGIN (* Print National Only *) 

(* initialization *) 

P_GL_CHARACTER_SET ; = P_CURRENT_NRCS ; 

(* transmit data as characters from GL *) 

(* for each line *) 

FOR Y:= TOP TO BOTTOM DO 
BEGIN 

(* set end of line to skip trailing spaces *) 

P_END_OF_LINE - END_OF_LINE ( Y ) ; 

WHILE (DISPLAYt Y,P_END_OF_LINE] .CODE - SPACE_CODE ) AND 
(P_END_OF_LINE >0) DO 
P_END_OF_LINE:= P_END_OF_LINE - 1; 

(* for each character in the current line *) 

FOR X;- 1 TO P_END_OF_LINE DO 
BEGIN 

(* if not in current NRCS *) 

IF DISPLAYt Y,X] .CHARACTER_SET <> P_GL_CHARACTER_SET THEN 
BEGIN 

(* do fallback - to be specified *) 

END 

ELSE 

(* otherwise send character code to printer *) 

WRITE ( PRINTER_PORT, CHR ( DI SPLAY[ Y , X ] . CODE ) ) ; 

END; (* end for each character *) 

WRITE (PRINTER_PORT, '<CR><LF>' ) ; 

END; (* end for each line *) 

IF PRINT_FORM_FEED_MODE = PRINT_FF_ON THEN 
WRITE (PRINTER_PORT, '<FF>' ) ; 

(* no termination sequence required *) 

END; (* end National Only *) 

ELSE IF PRINTER_STYLE = NATIONAL_PLUS_LINE_DRAWING THEN 
BEGIN 

(* Printer Style is National + Line Drawing *) 

(* initialization sequence *) 

P_RENDITION[BOLD] := FALSE; 

P_RENDITIONt UNDERSCORE] := FALSE; 

P_RENDITION(BLINK] := FALSE; 

P_RENDITION( REVERSE ] := FALSE; 

WRITE ( PRINTER_PORT, ' <CSI>0m' ) ; 

P_GL_CHARACTER_SET : = P_CURRENT_NRCS ; 

(* designate current NRCS as GO 

ASCII is NRCS for North America *) 

WRITE (PRINTER_PORT, '<ESC>{'); 

WRITE ( PRINTER_PORT , CHARACTER_SET_DSCS [ P_GL_CHARACTER_SET ] ) ; 
(* designate line drawing as G1 *) 

WRITE ( PRINTER_PORT, '<ESC>)0'); 

(* invoke GO to GL *) 
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WRITE (PRINTER_PORT, '<SI>'); 

(* data transmission *) 

(* for each line *) 

FOR Y:- TOP TO BOTTOM DO 
BEGIN 

(* set line rendition *) 

SEND_LINE_ATTRIBUTES(LINE_RENDITION[Y] ) ; 

(* set end of line to skip trailing spaces 
with "normal" graphic rendition *) 

P_END_OF_LINE - END_OF_LINE( Y ) ; 

WHILE (DISPLAY( Y,P_END_OF_LINE] .CODE - SPACE_CODE) AND 
(P_END_OF_LINE > 0) AND 

(NOT DISPLAYt Y,P_END_OF_LINE] .RENDITION[BOLD] ) AND 
(NOT DISPLAYt Y,P_END_OF_LINE] .RENDITION(UNDERSCORE] ) AND 
(NOT DISPLAYt Y,P_END_OF_LINE] .RENDITION[BLINK] ) AND 
(NOT DISPLAYt Y,P_END_OF_LINE] .RENDITION( REVERSE ] ) DO 
P_END_OF_LINE:= P_END_OF_LINE - 1; 

(* for each character in the current line *) 

FOR X:= 1 TO P_END_OF_LINE DO 
BEGIN 

(* set graphic rendition if it has changed *) 

SEND_GRAPHIC_RENDITION ( P_RENDITION , DI SPLAY [ X , Y ]. RENDITION ) 
P_RENDITION[ BOLD] ;= DISPLAY] Y , X ]. RENDITION [ BOLD ] ; 
P_RENDITION[ UNDERSCORE] := 

DISPLAY] Y,X] .RENDITION] UNDERSCORE] ; 

P_RENDITIONl BLINK] ;= DISPLAY] Y,X] . RENDITION ] BLINK ] ; 
P_RENDITION] REVERSE] := 

DISPLAY] Y,X] .RENDITION] REVERSE] ; 

(* new character set? *) 

IF DISPLAY] Y,X] .CHARACTER_SET <> P_GL_CHARACTER_SET THEN 
BEGIN 

(* yes, send SCS sequence to printer *) 

CASE DISPLAY] Y,X] .CHARACTER_SET OF 

P_CURRENT_NRCS : 

BEGIN 

(* character set is current NRCS *) 

(* invoke GO to GL *) 

WRITE ( PRINTER_PORT, '<SI>'); 

P_GL_CHARACTER_SET:= DI SPLAY ] Y , X ]. CHARACTER_SET ; 

END; 

LINE_DRAWING: 

BEGIN 

(* character set is Line Drawing *) 

(* is Line Drawing in Gl? *) 

IF P_G1_DESIGNATE <> LINE_DRAWING THEN 
BEGIN 

(* no, re-designate it *) 

WRITE ( PRINTER_PORT, '<ESC>)0'); 

P Gl DESIGNATE := LINE DRAWING; 
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END ; 

(* invoke Gl to GL * ) 

WRITE ( PRINTER_PORT, ' <SO > ' ) } 

P_GL_CHARACTER_SET:- DISPLAY[y,X] . CHARACTER_SET ; 
END; 

ASCII_G: 

(* character set is ASCII *) . 

(* is ASCII current NRCS? *) 

IF P_CURRENT_NRCS <> ASCII_G THEN 
BEGIN 

(* no, if it's not already in Gl , designate it *) 
IF P_G1_DESIGNATE <> ASCII_G THEN 
BEGIN 

WRITE (PRINTER_PORT, '<ESC>)B'); 
P_G1_DESIGNATE:= ASCII_G; 

END ; 

(* invoke Gl to GL *) 

WRITE ( PRINTER_PORT, '<SO>'); 

P_GL_CHARACTER_SET:= DISPLAY[Y,X] . CHARACTER_SET; 
END; 

OTHERWISE; IGNORE; 

END; (* end case of display character set *) 

END; (* end new character set *) 

(* do we need to fallback? *) 

IF (DISPLAY[X, Y] .CHARACTER_SET <> P_CURRENT_NRCS ) AND 
(DISPLAY[X, Y] .CHARACTER_SET <> LINE_DRAWING ) AND 
(DISPLAY[X,Y] .CHARACTER_SET <> ASCII_G) THEN 
BEGIN 

(* do fallback - to be specified *) 

END 

ELSE 

(* no, just send character code to printer *) 

WRITE ( PRINTER_PORT, CHR ( DISPLAY( Y , X ] . CODE ) ) ; 

END; (* end for each character in the current line *) 
WRITE (PRINTER_PORT, '<CR><LF>' ) ; 

END; (* end for each line *) 

IF PRINT_FORM_FEED_MODE = PRINT_FF_ON THEN 
WRITE (PRINTER_PORT, '<FF>' ) ; 

(* termination sequence *) 

(* send LSO if necessary to leave GO invoked to GL *) 

IF P_GL_CHARACTER_SET <> P_CURRENT_NRCS THEN 
WRITE (PRINTER_PORT, '<SI>'); 

(* if Line Drawing isn't in Gl , designate it *) 

IF P_G1_DESIGNATE <> LINE_DRAWING THEN 
WRITE (PRINTER_PORT, '<ESC>)0'); 

END; (* end printer style is National + Line Drawing *) 


ELSE IF PRINTER STYLE 


ALL CHARACTERS THEN 
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BEGIN 

(* printer style is All Characters *) 

(* initialization sequence *) 

P_RENDITIONtBOLD] FALSE; 

P_REND I TI ON (UNDERSCORE] ;» FALSE; 

P_RENDITION[ BLINK] :» FALSE; 

P_RENDITION[ REVERSE] := FALSE; 

WRITE (PRINTER_PORT, '<CSI>0m' ) ; 

(* initialize printer G sets to correspond with terminal *) 

WRITE (PRINTER_PORT, '<ESC>('); 

WRITE (PRINTER_PORT, CHARACTER_SET_DSCS [ DESIGNATED_GRAPHIC_SETS ( GO ] ] ) ; 

IF CHARACTER_SET_SIZE(DESIGNATED_GRAPHIC_SETS(G1 ] ] - 94 THEN 
WRITE (PRINTER_PORT, '<ESC>)',); 

ELSE 

WRITE (PRINTER_PORT, '<ESC>-'); 

WRITE (PRINTER_PORT, CHARACTER_SET_DSCS [ DESIGNATED_GRAPHIC_SETS [ Gl ] ] ) ; 

IF CHARACTER_SET_SIZE[DESIGNATED_GRAPHIC_SETS{G2] ] - 94 THEN 
WRITE (PRINTER_PORT, '<ESC>*'); 

ELSE 

WRITE (PRINTER_PORT, '<ESC>.'); 

WRITE (PRINTER_PORT, CHARACTER_SET_DSCS ( DESIGNATED_GRAPHIC_SETS [ G2 ] ] ) ; 

IF CHARACTER_SET_SIZE[DESIGNATED_GRAPHIC_SETS(G3 ] ] = 94 THEN 
WRITE (PRINTER_PORT, '<ESC>+'); 

ELSE 

WRITE ( PRINTER_PORT, '<ESC>/'); 

WRITE ( PRINTER_PORT, CHARACTER_SET_DSCS [ DESIGNATED_GRAPHIC_SETS [ G3 ] ] ) ; 

(* send LSO to invoke GO to GL *) 

WRITE ( PRINTER_PORT, '<SI>'); 

P_GL_CHARACTER_SET:- DESIGNATED_GRAPHIC_SETS [ GO ] ; 

(* if 8-bit printer port environment *) 

IF PRINTER_PORT_ENVIRONMENT = EIGHT_BIT THEN 
BEGIN 

(* send LS2R to invoke G2 to GR *) 

WRITE (PRINTER_PORT, '<ESC>}'); 

P_GR_CHARACTER_SET:= DESIGNATED_GRAPHIC_SETS ( G2 ] ; 

END ; 


(* data transmission *) 

FOR Y:= TOP TO BOTTOM DO 
BEGIN 

(* set line rendition *) 

SEND_LINE_ATTRIBUTES{ LINE_RENDITION[ Y] ) ; 

(* set end of line to skip trailing spaces 
with "normal" graphic rendition *) 

P_END_OF_LINE = END_OF_LINE ( Y ) ; 

WHILE (DISPLAY] Y,P_END_OF_LINE] .CODE = SPACE_CODE) AND 
(P END OF LINE > 0) AND 
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(NOT DISPLAY! Y,P_END_OF_LINE] . RENDITIONI BOLD] ) AND 
(NOT DISPLAY! Y,P_END_OF_LINE] .RENDITIONiuNDERSCORE] ) AND 
(NOT DISPLAY! Y,P_END_OF_LINE]. RENDITION! BLINK ] ) AND 
(NOT DISPLAY! Y,P_END_OF_LINE] .RENDITION! REVERSE ] ) DO 
P_END_OF_LINE:= P_END_OF_LINE - 1; 

(* for each character in the current line *) 

FOR X:= 1 TO P_END_OF_LINE DO 
BEGIN 

(* set graphic rendition *) 

SEND_GRAPHIC_RENDITION ( P_RENDITION, DISPLAY!X,Y] .RENDITION) ; 
P_RENDITION!BOLD] :» DISPLAY! Y,X] . RENDITION! BOLD ] ; 

P_RENDITION! UNDERSCORE ] ;» 

DISPLAY! Y,X] .RENDITION! UNDERSCORE] ; 

P_RENDITION! BLINK] DISPLAY] Y,X] . RENDITION] BLINK ] ; 

P_REND I TION] REVERSE] :* 

DISPLAY] Y,X] .RENDITION] REVERSE] ; 

(* handle 7-bit/8-bit printer port environment separately *) 

(* if 7-bit printer port environment *) 

IF PRINTER_PORT_ENVIRONMENT - SEVEN_BIT THEN 
BEGIN 

(* new character set? *) 

IF DISPLAY] Y,X] .CHARACTER_SET <> P_GL_CHARACTER_SET THEN 
BEGIN 

(* yes, designate and invoke as needed *) 

CASE DISPLAY! Y,X] .CHARACTER_SET OF 

DESIGNATED_GRAPHIC_SETS!GO] : 

(* character set is in GO *) 

(* send LSO to invoke GO to GL * ) 

WRITE ( PRINTER_PORT, '<SI>'); 

DESIGNATED_GRAPHIC_SETS(G1 ] : 

(* character set is in G1 *) 

(* send LSI to invoke G1 to GL * ) 

WRITE (PRINTER_PORT, '<SO>'); 

DESIGNATED_GRAPHIC_SETS!G2] : 

(* character set is in G2 *) 

(* send SS2 to invoke G2 to GL *) 

WRITE ( PRINTER_PORT, '<ESC>N'); 

DESIGNATED_GRAPHIC_SETS!G3 ] : 

(* character set is in G3 *) 

(* send SS3 to invoke G3 to GL *) 

WRITE (PRINTER_PORT, '<ESC>0'); 

OTHERWISE: 

BEGIN 

(* no fallback for print all characters *) 

(* designate the displayed set as G3 *) 

IF CHARACTER_SET_SIZE!DISPLAY! Y,X] .CHARACTER_SET] =94 THEN 
WRITE (PRINTER PORT, '<ESC>+'); 
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ELSE 

WRITE ( PRINTER_PORT, '<ESC>/'); 

WRITE (PRINTER_PORT, CHARACTER_SET_DSCS 
[DISPLAY[ Y,Xl .CHARACTER_SET] ) ; 
P_DESIGNATED_CHARACTER_SETS [ G3 ] : » 

DISPLAY! Y, XI .CHARACTER_SET; 

(* send SS3 to invoke G3 to GL *) 

WRITE ( PRINTER_PORT, '<ESC>0'); 

END ; 

END; (* end case of display character set *) 

P_GL_CHARACTER_SET:» DI SPLAY [Y,X] . CHARACTER_SET ; 

END; (* end new character set *) 

END (* end 7-bit printer port environment *) 

ELSE 

(* 8-bit printer port environment *) 

BEGIN 

(* new character set? *) 

IF (DISPLAY! Y,X] .CHARACTER_SET <> P_GL_CHARACTER_SET ) AND 
(DISPLAY! Y,X] .CHARACTER_SET <> P_GR_CHARACTER_SET ) THEN 
BEGIN 

(* yes, designate and invoke as needed *) 

CASE DISPLAY! Y,X] .CHARACTER_SET OF 

DESIGNATED_GRAPHIC_SETS!GO ] : 

BEGIN 

(* character set is in GO *) 

(* send LSO to invoke GO to GL *) 

WRITE ( PRINTER_PORT, '<SI>'); 

P_GL_CHARACTER_SET:= DISPLAY! Y,X] . CHARACTER_SET ; 

END ; 

DESIGNATED_GRAPHIC_SETS!G1 ] : 

BEGIN 

(* character set is in G1 *) 

(* send LSI to invoke Gl to GL * ) 

WRITE ( PRINTER_PORT, ’<S0>'); 

P_GL_CHARACTER_SET;= DISPLAY! Y,X] . CHARACTER_SET ; 

END; 

DESIGNATED_GRAPHIC_SETS!G2 ] ; 

BEGIN 

(* character set is in G2 *) 

(* send LS2R to invoke G2 to GR *) 

WRITE (PRINTER_PORT, '<ESC>}'); 

P_GR_CHARACTER_SET:= DISPLAY! Y,X] . CHARACTER_SET ; 

END ; 

DESIGNATED_GRAPHIC_SETS!G3] : 

BEGIN 

(* character set is in G3 *) 

(* send LS3R to invoke G3 to GR *) 
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WRITE (PRIigTER_PORT, '<ESC>|'); - 

P_GR_CHARACTER_SET;= DISPLAY! Y, X ]. CHARACTER_SET ; 

END; 

OTHERWISE; 

BEGIN 

(* no fallback for print all characters *) 

(* designate the displayed set to G3 *) 

IF CHARACTER_SET_SIZE[DISPLAY[Y,X] .CHARACTER_SET] - 94 THEN 
WRITE (PRINTER_PORT, '<ESC>+'); 

ELSE 

WRITE ( PRINTER_PORT, ' <ESC>/' ) ; 

WRITE (PRINTER_PORT, 

CHARACTER_SET_DSCS[DI SPLAY [y,X] . CHARACTER_SET ] ) ; 
P_DESIGNATED_CHARACTER_SETS ( G3 ] ; » 

DI SPLAY (Y,X] .CHARACTER_SET; 

(* send LS3R to invoke G3 to GR * ) 

WRITE ( PRINTER_PORT, ' <ESC> | ' ) ; 

P_GR_CHARACTER_SET:= DISPLAY(Y,X] . CHARACTER_SET ; 

END; 

END (* end case of display character set *) 

END; (* end new character set *) 

END; (* end 8-bit printer port environment *) 


(* send character code to printer *) 

WRITE (PRINTER_PORT, CHR ( DI SPLAY [ Y , X ]. CODE )) ; 

END; (* end for each character in the current line *) 

WRITE ( PRINTER_PORT, ' <CR><LF> ' ) ; 

END; (* end for each line *) 

IF PRINT_FORM_FEED_MODE = PRINT_FF_ON THEN 
WRITE { PRINTER_PORT, ' <FF> ' ) ; 

(* termination sequence *) 

(* send LSO if necessary to leave GO invoked to GL *) 

IF P_GL_CHARACTER_SET <> DESIGNATED_GRAPHIC_SETS [ GO ] THEN 
WRITE ( PRINTER_PORT, '<SI>'); 

(* if 8-bit printer port environment *) 

IF PRINTER_PORT_ENVIRONMENT = EIGHT_BIT THEN 
BEGIN 

(* send LS2R if necessary to leave G2 invoked to GR *) 

IF P_GR_CHARACTER_SET <> DESIGNATED_GRAPHIC_SETS[G2] THEN 
WRITE ( PRINTER_PORT, '<ESC>}'); 

END ; 

(* if printer G3 isn't same as terminal's, re-designate it *) 

IF P_DESIGNATED_GRAPHIC_SETS[G3 ] <> DESIGNATED_GRAPHIC_SETS [ G3 ] THEN 
BEGIN 

IF CHARACTER_SET_SIZE[DESIGNATED_GRAPHIC_SETS[G3 ] ] = 94 THEN 
WRITE (PRINTER_PORT, '<ESC>+'); 

ELSE 

WRITE ( PRINTER_PORT, '<ESC>/'); 

WRITE ( PRINTER_PORT, CHARACTER_SET_DSCS [ DESIGNATED_GRAPHIC_SETS [ G3 ] ] ) 
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END ; 

END; (* end printer style is All Characters *) 

END; (* end procedure PRINT_PAGE *) 

(* 

* Send Line Attributes 
* ) 

PROCEDURE SEND_LINE_ATTRIBUTES ( P_LINE_RENDITION : LINE_RENDITION_TYPE ) ; 
BEGIN 

(* set line rendition *) 

IF P_LINE_RENDITION - SINGLE_WIDTH THEN 
WRITE (PRINTER_PORT, ' <ESC>#5' ) ; 

IF P_LINE_RENDITION - DOUBLE_WIDTH THEN 
WRITE ( PRINTER_PORT, ' <ESC>#6 ' ) ; 

IF P_LINE_RENDITION = DOUBLE_HEIGHT_TOP THEN 
WRITE (PRINTER_PORT, '<ESC>#3' ) ; 

IF P_LINE_RENDITION - DOUBLE_HEIGHT_BOTTOM THEN 
WRITE ( PRINTER_PORT, ' <ESC>#4 ' ) ; 

END; (* end procedure SEND_LINE_ATTRIBUTES *) 

(* 

* Send Graphic Rendition 

* This procedure sends a new SGR to the printer port 

* if the graphic rendition has changed. 

* ) 

PROCEDURE SEND_GRAPHIC_RENDITION 

( CURRENT_RENDITION; CHARACTER_RENDITION_TYPE ; 

NEW_RENDITION: CHARACTER_RENDITION_TYPE ) ; 

BEGIN 

(* new graphic rendition? *) 

IF (CURRENT_RENDITIONlBOLD] <> NEW_RENDITION[ BOLD ] ) OR 

(CURRENT_RENDITION( UNDERSCORE] <> NEW_RENDITION [ UNDERSCORE ] ) OR 
(CURRENT_RENDITION[ BLINK] <> NEW_RENDITION [ BLINK ] ) OR 

( CURRENT_RENDITION[ REVERSE] <> NEW_RENDITION( REVERSE ] ) THEN 

BEGIN 

(* yes, send new SGR to printer *) 

WRITE (PRINTER_PORT, '<ESC>[0' ) ; 

IF NEW_RENDITION(BOLD] THEN 
WRITE ( PRINTER_PORT, ' ;1 ' ) ; 

IF NEW_RENDITION[ UNDERSCORE] THEN 
WRITE (PRINTER_PORT, ' ;4' ) ; 

IF NEW_RENDITION[ BLINK] THEN 
WRITE (PRINTER_PORT, ' ;5' ) ; 

IF NEW_RENDITION[ REVERSE] THEN 
WRITE (PRINTER_PORT, ' ;7' ) ; 

WRITE (PRINTER_PORT, 'm' ) ; 

END ; 

END; (* end procedure SEND_GRAPHIC_RENDITION *) 
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Known Deviations: None 

(algorithm does not include code for handling fallback) 
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I PRINT LINE MC 


I Levels IX, 2X, 3X 

Purpose: Transmit the line containing the Active Position to the 

printer port. 

Format: CSI ? 1 i 

9/11 3/15 3/1 6/9 

Description: The MC control with private parameter (indicated by 

3/15 "?") of 3/1 (one) causes a print function to be performed, in 
which the line containing the Active Position is transmitted to 
the printer port. b2 State Affected: None 


Algorithm: 

PROCEDURE PRINT_LINE; 

VAR Y: LINE_TYPE; 

X : COLUMN_TYPE ; 

P_END_OF_LINE: INTEGER; 

P_LINE_RENDITION: LINE_RENDITION_TYPE ; 

P_REND I T I ON : CHARACTER_REND I T I ON_T YPE ; 
P_GL_CHARACTER_SET : GRAPHICS_CHARACTER_SET_TYPE ; 
P_GR_CHARACTER_SET : GRAPHICS_CHARACTER_SET_TYPE ; 
P_CURRENT_NRCS : GRAPHI CS_CHARACTER_SET_TYPE ; 

P_G1_DESIGNATE : GRAPHICS_CHARACTER_SET_TYPE ; 

(* determine current National character set *) 
P_CURRENT_NRCS;= ASCII_G; 

IF ( CHARACTER_SET_MODE = SEVEN_BITS) AND 
( KEYBOARD_USAGE_MODE - TYPEWRITER) THEN 
P_CURRENT_NRCS : - NRCS_TABLE ( KEYBOARD_DIALECT ) ; 

(* handle each printer style separately *) 

IF PRINTER_STYLE = NATIONAL_ONLY THEN 
BEGIN (* Print National Only *) 

(* initialization *) 

P_GL_CHARACTER_SET : = P_CURRENT_NRCS ; 

(* transmit data as characters from GL * ) 

(* transmit current line *) 

Y = ACTIVE_POSITION.LINE; 

(* set end of line to skip trailing spaces *) 
P_END_OF_LINE = END_OF_LINE ( Y ) ; 

WHILE (DISPLAY[ Y,P_END_OF_LINE] .CODE = SPACE_CODE) AND 
( P_END_OF_LINE >0) DO 
P_END_OF_LINE:- P_END_OF_LINE - 1 ; 

(.* for each character in the current line *) 

FOR X:= 1 TO P_END_OF_LINE DO 
BEGIN 



VSRM - Printer Port Extension EL-00070-07 

*** COMPANY CONF - DEC Internal Use Only 28-Apr-1987 


Page 7-50 


(* if not in current NRCS *) 

IF DISPLAY[ Y,X] .CHARACTER_SET <> P_GL_CHARACTER_SET THEN 
BEGIN 

(* do fallback - to be specified *) 

END 

ELSE 

(* otherwise send character code to printer *) 

WRITE ( PRINTER_PORT, CHR( DISPLAY[ Y,X] . CODE ) ) ; 

END; (* end for each character in line *) 

WRITE ( PRINTER_PORT, ' <CR><LF> ' ) ; 

(* no termination sequence required *) 

END; (* end National Only *) 

ELSE IF PRINTER_STYLE = NATIONAL_PLUS_LINE_DRAWING THEN 
BEGIN 

(* Printer Style is National + Line Drawing *) 

(* initialization sequence *) 

P_RENDITION[ BOLD] := FALSE; 

P_RENDITION[ UNDERSCORE I := FALSE; 

P_RENDITION( BLINK ] ;- FALSE; 

P_RENDITION( REVERSE ] :- FALSE; 

WRITE (PRINTER_PORT, '<CSI>0m' ) ; 

P_GL_CHARACTER_SET ; - P_CURRENT_NRCS ; 

(* designate current NRCS as GO 

ASCII is NRCS for North America *) 

WRITE ( PRINTER_PORT, ' <ESC>( ' ) ; 

WRITE ( PRINTER_PORT , CHARACTER_SET_DSCS [ P_GL_CHARACTER_SET ] ) ; 

(* designate line drawing as Gl *) 

WRITE ( PRINTER_PORT, '<ESC>)0'); 

(* invoke GO to GL *) 

WRITE ( PRINTER_PORT, '<SI>'); 

(* data transmission *) 

Y - ACTIVE_POSITION.LINE; 

(* set line rendition *) 

SEND_LINE_ATTRIBUTES(LINE_RENDITION[ Y] ) ; 

(* set end of line to skip trailing spaces 
with "normal" graphic rendition *) 

P_END_OF_LINE = END_OF_LINE ( Y ) ; 

WHILE (DISPLAY[Y,P_END_OF_LINE] .CODE = SPACE_CODE) AND 
(P_END_OF_LINE > 0) AND 

(NOT DISPLAY! Y,P_END_0F_LINE] .RENDITION[ BOLD] ) AND 
(NOT DISPLAY! Y,P_END_OF_LINE] .RENDITION! UNDERSCORE ] ) AND 
(NOT DISPLAY! Y,P_END_OF_LINE] .RENDITION! BLINK ] ) AND 
(NOT DISPLAY! Y,P_END_OF_LINE] .RENDITION!REVERSE] ) DO 
P_END_OF_LINE;= P_END_OF_LINE - 1; 

(* for each character in the current line *) 

FOR X:- 1 TO P_END_OF_LINE DO 
BEGIN 

(* set graphic rendition if it has changed *) 

SEND_GRAPHIC_RENDITION ( P_RENDITION , DISPLAY!X,Y].RENDITI0N); 
P_RENDITION!BOLD] :* DISPLAY! Y,X] . RENDITION! BOLD ] ; 

P RENDITION! UNDERSCORE ] := 
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- DISPLAY[ Y,X] .RENDITION[UNDERSCORE] ; 

P_RENDITION[ BLINK] DISPLAY] Y,X] . RENDl’tlON] BLINK ] ; 
P_RENDITI ON [REVERSE] 

DISPLAY! Y,X] .RENDITION [REVERSE] ; 

(* new character set? *) 

IF DISPLAY] Y,X] .CHARACTER_SET <> P_GL_CHARACTER_SET THEN 
BEGIN 

(* yes, send SCS sequence to printer *) 

CASE DISPLAY] Y,X] .CHARACTER_SET OF 

P_CURRENT_NRCS : 

BEGIN 

(* character set is current NRCS *) 

(* invoke GO to GL *) 

WRITE (PRINTER_PORT, '<SI>'); 

P_GL_CHARACTER_SET:= DI SPLAY [Y,X] . CHARACTER_SET ; 
END ; 

LINE_DRAWING; 

BEGIN 

(* character set is Line Drawing *) 

(* is Line Drawing in Gl? *) 

IF P_G1_DESIGNATE <> LINE_DRAWING THEN 
BEGIN 

(* no, re-designate it *) 

WRITE ( PRINTER_PORT, '<ESC>)0'); 

P_G1_DESIGNATE:= LINE_DRAWING; 

END; 

(* invoke Gl to GL *) 

WRITE ( PRINTER_PORT, ' <SO> ' ) ; 

P_GL_CHARACTER_SET : - DISPLAY [ Y , X ] . CHARACTER_SET ; 

END ; 

ASCII_G: 

(* character set is ASCII *) 

(* is ASCII current NRCS? *) 

IF P_CURRENT_NRCS <> ASCII_G THEN 
BEGIN 

(* no, if it's not already in Gl , designate it *) 
IF P_G1_DESIGNATE <> ASCII_G THEN 
BEGIN 

"WRITE ( PRINTER_PORT, '<ESC>)B'); 
P_G1_DESIGNATE:= ASCII_G; 

END; 

( * invoke Gl to GL * ) 

WRITE (PRINTER_PORT, '<SO>'); 

P_GL_CHARACTER_SET:= DI SPLAY] Y,X] . CHARACTER_SET ; 
END ; 

OTHERWISE: IGNORE; 

END; (* end case of display Character set *) 

END; {* end new character set *) 

(* do we need to fallback? *) 
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IF ( DI SPLAY [ X, Y] .CHARACTER_SET P_CURRENT_NRCS ) AND 
(DISPLAY[X, Y] .CHARACTER_SET <> LINE_DRAWING ) AND 
(DISPLAY[X, Y] .CHARACTER_SET <> ASCII_G) THEN 
BEGIN 

(* do fallback - to be specified *) 

END 

ELSE 

(* no, just send character code to printer *) 

WRITE (PRINTER_PORT, CHR ( DISPLAY [ Y , X ]. CODE )) ; 

END; (* end for each character in the current line *) 

WRITE ( PRINTER_PORT, '<CR><LF>' ) ; 

(* termination sequence *) 

(* send LSO if necessary to leave GO invoked to GL *) 

IF P_GL_CHARACTER_SET <> P_CURRENT_NRCS THEN 
WRITE (PRINTER_PORT, '<S1>'); 

(* if Line Drawing isn't in Gl , designate it *) 

IF P_G1_DESIGNATE <> LINE_DRAWING THEN 
WRITE (PRINTER_PORT, '<ESC>)0'); 

END; (* end printer style is National + Line Drawing *) 

ELSE IF PRINTER_STYLE » ALL_CHARACTERS THEN 
BEGIN 

(* printer style is All Characters *) 

(* initialization sequence *) 

P_RENDITION[BOLD] := FALSE; 

P_RENDITION[ UNDERSCORE] := FALSE; 

P_RENDITION[BLINK] := FALSE; 

P_RENDI TI ON ( REVERSE ] :=• FALSE; 

WRITE (PRINTER_PORT, '<CSI>0m' ) ; 

(* initialize printer G sets to correspond with terminal *) 

WRITE (PRINTER_PORT, '<ESC>('); 

WRITE (PRINTER_PORT, CHARACTER_SET_DSCS [ DESIGNATED_GRAPHIC_SETS [ GO ] ] ) ; 

IF CHARACTER_SET_SIZE[DESIGNATED_GRAPHIC_SETS[G1] ] = 94 THEN 
WRITE ( PRINTER_PORT, '<ESC>)'); 

ELSE 

WRITE (PRINTER_PORT, '<ESC>-'); 

WRITE ( PRINTER_PORT, CHARACTER_SET_DSCS [ DESIGNATED_GRAPHIC_SETS ( Gl ] ] ) ; 

IF CHARACTER_SET_SIZEtDESIGNATED_GRAPHIC_SETS[G2 ] ] = 94 THEN 
WRITE ( PRINTER_PORT, '<ESC>*'); 

ELSE 

WRITE (PRINTER_PORT, ' <ESC> . ' ) ; 

WRITE ( PRINTER_PORT, CHARACTER_SET_DSCS [ DESIGNATED_GRAPHIC_SETS [ G2 ] ] ) ; 

IF CHARACTER_SET_SIZE(DESIGNATED_GRAPHIC_SETS[G3 ] ] = 94 THEN 
WRITE (PRINTER_PORT, '<ESC>+'); 

ELSE 

WRITE ( PRINTER_PORT, ' <ESC>/' ) ; 

WRITE ( PRINTER_PORT, CHARACTER_SET_DSCS [ DESIGNATED_GRAPHIC_SETS ( G3 ] ) ) ; 
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(* send LSO to invoke GO to GL * ) 

WRITE (PRINTER_PORT, '<SI>'); 

P_GL_CHARACTER_SET: = DESIGNATED_GRAPHIC_SETS ( GO ] ; 

(* if 8-bit printer port environment *) 

IF PRINTER_PORT_ENVIRONMENT » EIGHT_BIT THEN 
BEGIN 

(* send LS2R to invoke G2 to GR *) 

WRITE ( PRINTER_PORT, '<ESC>}'); 

P_GR_CHARACTER_SET:- DESIGNATED_GRAPHIC_SETS [ G2 ] ; 

END; 

(* data transmission *) 

Y - ACTIVE_POSITION.LINE; 

(* set line rendition *) 

SEND_LINE_ATTRIBUTES(LINE_RENDITION[Y] ) ; 

(* set end of line to skip trailing spaces 
with "normal" graphic rendition *) 

P_END_OF_LINE = END_OF_LINE ( Y ) ; 

WHILE (DISPLAY! Y,P_END_OF_LINE] .CODE = SPACE_CODE) AND 
{P_END_OF_LINE > 0) AND 

(NOT DISPLAY! Y,P_END_OF_LINE] .RENDITION [BOLD] ) AND 
(NOT DISPLAY! Y,P_END_OF_LINE] .RENDITION! UNDERSCORE ] ) AND 
(NOT DISPLAY! Y,P_END_OF_LINE] .RENDITION! BLINK ] ) AND 
(NOT DISPLAY! Y,P_END_OF_LINE] .RENDITION!REVERSE] ) DO 
P_END_OF_LINE:= P_END_OF_LINE - 1;. 

(* for each character in the current line *) 

FOR X:- 1 TO P_END_OF_LINE DO 
BEGIN 

(* set graphic rendition *) 

SEND_GRAPHIC_RENDITION ( P_RENDITION, DISPLAY!X,Y].RENDITION); 
P_RENDITION!BOLD] := DISPLAY! Y,X] . RENDITION! BOLD ] ; 

P_RENDITION! UNDERSCORE] : = 

DISPLAY! Y,X] .RENDITION! UNDERSCORE] ; 

P_RENDITION! BLINK] :» DISPLAY! Y,X] . RENDITION! BLINK ] ; 
P_RENDITION! REVERSE] := 

DISPLAY! Y,X] .RENDITION! REVERSE] ; 

(* handle 7-bit/8-bit printer port environment separately *) 
{* if 7-bit printer port environment *) 

IF PRINTER_PORT_ENVIRONMENT = SEVEN_BIT THEN 
BEGIN 

(* new character set? *) 

IF DISPLAY! Y,X] .CHARACTER_SET <> P_GL_CHARACTER_SET THEN 
BEGIN- 

(* yes, designate and invoke as needed *) 

CASE DISPLAY! Y,X] .CHARACTER_SET OF 

DESIGNATED_GRAPHIC_SETS!GO] : 

(* character set is in GO *) 

(* send LSO to invoke GO to GL * ) 

WRITE (PRINTER PORT, ’ <SI> ’ ) ; 
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DESIGNATED_GRAPHIC_SETStGl ] : 

(* character set is in Gl'*) 

(* send LSI to invoke Gl to GL *) 

WRITE ( PRINTER_PORT, ' <SO> ' ) ; 

DESIGNATED_GRAPHIC_SETStG2 ] : 

(* character set is in G2 *) 

(* send SS2 to invoke G2 to GL *) 

WRITE (PRINTER_PORT, '<ESC>N'); 

DESIGNATED_GRAPHIC_SETS[G3] : 

(* character set is in G3 *) 

{* send SS3 to invoke G3 to GL *) 

WRITE (PRINTER_PORT, '<ESC>0'); 

OTHERWISE: 

BEGIN 

(* no fallback for print all characters *) 

(* designate the displayed set as G3 *) 

IF CHARACTER_SET_SIZE[DISPLAY[ Y,X] .CHARACTER_SET] - 94 THEN 
WRITE (PRINTER_PORT, '<ESC>+'); 

ELSE 

WRITE (PRINTER_PORT, '<ESC>/'); 

WRITE ( PRINTER_PORT, CHARACTER_SET_DSCS 
[DISPLAY[ Y,X] .CHARACTER_SET] ) ; 

P_DESIGNATED_CHARACTER_SETS [G3]:- 
DISPLAY[Y,X] .CHARACTER_SET; 

(* send SS3 to invoke G3 to GL * ) 

WRITE (PRINTER_PORT, '<ESC>0'); 

END ; 

END; (* end case of... *) 

P_GL_CHARACTER_SET:= DISPLAY[ Y,X] . CHARACTER_SET ; 

END; (* end new character set *) 

END (* end 7-bit printer port environment *) 

ELSE 

(* 8-bit printer port environment *) 

BEGIN 

(* new character set? *) 

IF (DISPLAY! Y,X] .CHARACTER_SET <> P_GL_CHARACTER_SET) AND 
(DISPLAY! Y,X] .CHARACTER_SET <> P_GR_CHARACTER_SET ) THEN 
BEGIN 

(* yes, designate and invoke as needed *) 

GASE DISPLAY! Y,X] .CHARACTER_SET OF 

DESIGNATED_GRAPHIC_SETS!GO] : 

BEGIN 

(* character set is in GO *) 

(* Send LSO to invoke GO to GL *) 

WRITE (PRINTER_PORT, '<SI>'); 

P_GL_CHARACTER_SET:= DISPLAY! Y,X] . CHARACTER_SET ; 

■ END; 
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DESIGNATED_GRAPHIC_SETS(G1 ] ; 

BEGIN 

(* character set is in G1 *) 

(* send LSI to invoke Gl to GL * ) 

WRITE ( PRINTER_PORT, ' <SO> ' ) ; 

P_GL_CHARACTER_SET:- DI SPLAY [Y,XI .CHARACTER_SET; 

END; 

DESIGNATED_GRAPHIC_SETS[G2] ; 

BEGIN 

(* character set is in G2 *) 

(* send LS2R to invoke G2 to GR *) 

WRITE (PRINTER_PORT, '<ESC>}'); 

P_GR_CHARACTER_SET:- DI SPLAY [Y,X] .CHARACTER_SET; 

END; 

DESIGNATED_GRAPHIC_SETS [ G3 ] : 

BEGIN 

(* character set is in G3 *) 

(* send LS3R to invoke G3 to GR *) 

WRITE ( PRINTER_PORT, '<ESC>|'); 

P_GR_CHARACTER_SET;=» DI SPLAY[ Y , X ] . CHARACTER_SET ; 

END; 

OTHERWISE: 

BEGIN 

(* no fallback for print all characters *) 

(* designate the displayed set to G3 *) 

IF CHARACTER_SET_SIZE[DISPLAY[ Y,X] .CHARACTER_SET] = 94 
WRITE (PRINTER_PORT, '<ESC>+'); 

ELSE 

WRITE ( PRINTER_PORT, '<ESC>/'); 

WRITE ( PRINTER_PORT, 

CHARACTER_SET_DSCS (DI SPLAY [ Y,X] . CHARACTER_SET ] ) 
P_DESIGNATED_CHARACTER_SETS(G3 ] := 

DISPLAY[ Y,X] .CHARACTER_SET; 

(* send LS3R to invoke G3 to GR *) 

WRITE ( PRINTER_PORT, '<ESC>|'); 

P_GR_CHARACTER_SET:= DI SPLAY (Y,X] . CHARACTER_SET ; 

END; 

END (* end case of... *) 

END; (* end new character set *) 

END; (* end 8-bit printer port environment *) 

(* send character code to printer *) 

WRITE ( PRrNTER_PORT, CHR( DISPLAY[ Y, X ] . CODE ) ) ; 

END; (* end for each character in the current line *) 

WRITE ( PRINTER_PORT, ' <CR><LF> ' ) ; 

(* termination sequence *) 

(* send LSO if necessary to leave GO invoked to GL *) 


THEN 
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IF P_GL_CHARACTER_SET <> DESIGNATED_GRAPHIC_SETS [ GO ] THEN 
WRITE (PRINTER_PORT, '<SI>'); 

(* if 8-bit printer port environment *) 

IF PRINTER_PORT_ENVIRONMENT = EIGHT_BIT THEN 
BEGIN 

(* send LS2R if necessary to leave G2 invoked to GR *) 

IF P_GR_CHARACTER_SET <> DESIGNATED_GRAPHIC_SETS [ G2 ] THEN 
WRITE (PRINTER_PORT, '<ESC>}'); 

END; 

(* if printer G3 isn't same as terminal's, re-designate it *) 

IF P_DESIGNATED_GRAPHIC_SETS[G3 ] <> DESIGNATED_GRAPHIC_SETS [ G3 ] THEN 
BEGIN 

IF CHARACTER_SET_SIZE[DESIGNATED_GRAPHIC_SETStG3 ] ] = 94 THEN 
WRITE (PRINTER_PORT, '<ESC>+'); 

ELSE 

WRITE (PRINTER_PORT, '<ESC>/'); 

WRITE (PRINTER_PORT, CHARACTER_SET_DSCS [ DESIGNATED_GRAPHIC_SETS [ G3 ] ]>• 
END; 

END; (* end printer style is All Characters *) 

END; (* end procedure PRINT_LINE *) 

( * 

* Send Line Attributes 
* ) 

PROCEDURE SEND_LINE_ATTRIBUTES ( P_LINE_RENDITION ; LINE_RENDITION_TYPE ) ; 
BEGIN 

(* set line rendition *) 

IF P_LINE_RENDITION = SINGLE_WIDTH THEN 
WRITE ( PRINTER_PORT, ' <ESC>#5' ) ; 

IF P_LINE_RENDITION = DOUBLE_WIDTH THEN 
WRITE (PRINTER_PORT, '<ESC>#6' ) ; 

IF P_LINE_RENDITION = DOUBLE_HEIGHT_TOP THEN 
WRITE (PRINTER_PORT, '<ESC>#3' ) ; 

IF P_LINE_RENDITION * DOUBLE_HEIGHT_BOTTOM THEN 
WRITE (PRINTER_PORT, '<ESC>#4' ) ; 

END; (* end procedure SEND_LINE_ATTRIBUTES *) 

(* 

* Send Graphic Rendition . 

* This procedure sends a new SGR to the printer port 

* if the graphic rendition has changed. 

*) 

• PROCEDURE SEND_GRAPHIC_RENDITION 

(CURRENT_RENDITION: CHARACTER_RENDITION_TYPE ; 

NEW_RENDITION: CHARACTER_RENDITION_TYPE ) ; 

BEGIN 

(* new graphic rendition? *) 

IF (CURRENT_RENDITION[BOLDl <> NEW_RENDTION[ BOLD ] ) OR 

(CURRENT_RENDITION( UNDERSCORE] <>. NEW_RENDITION [ UNDERSCORE ] ) OR 
(CURRENT RENDITION[ BLINK] <> NEW RENDITION [ BLINK ] ) OR 
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(CURRENT_RENDIT I ON [REVERSE] <> NEW_RENDI TI ON [ REVERSE ] ) THEN 

BEGIN 

(* yes, send new SGR to printer *) 

WRITE {PRINTER_PORT, '<ESC>[ 0' ) ; 

IF NEW_RENDITION[BOLD] THEN 
WRITE ( PRINTER_PORT, 

IF NEW_RENDITION[ UNDERSCORE] THEN 
WRITE ( PRINTER_PORT, ' ; 4 ' ) ; 

IF NEW_RENDITION[ BLINK] THEN 
WRITE ( PRINTER_PORT, ' ; 5 ' ) ; 

IF NEW_RENDITION( REVERSE] THEN 
WRITE ( PRINTER_PORT, '}!•)', 

WRITE (PRINTER_PORT, 'm' ) ; 

END; 

END; (* end procedure SEND_GRAPHIC_RENDITION *) ' 


Known Deviations: None 

(algorithm does not include code for handling fallback) 
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7.8 GRAPHICS PRINTING 

This section describes graphics printing and is intended to apply 
to devices which support graphic displays and the Sixel Graphics 
Extension. 


7.8.1 Graphics Print Operations 

7. 8. 1.1 Graphics Print Screen 

The complete graphics bit map is transferred to the printer. This 
can be invoked by the host through the ReGIS hardcopy command or 
by the user under local control. 


7. 8. 1.2 Graphics Print. Region 

An image of a portion of the screen bit map is transferred to the 
printer. This can be invoked by the host through the ReGIS 
hardcopy command. Refer to the ReGIS chapter for determining how 
to define this region. 


7.8.2 Sixel Printing 

A Sixel is a group of 6 vertical pixels represented by 6 bits 
within a character code. A one value for a bit indicates that a 
pixel-spot will be placed at the corresponding grid . position, a 
zero will cause the corresponding grid position to be unchanged 
( not written) . 

Sixel printing consists of setting context and attributes for the 
pixels and then printing each Sixel in lef t-to-r ight , 
top-to-bottom order. Wherever possible, run-length encoding is 
used to reduce the number of characters transmitted for a line of 
Sixels. 

See the Sixel Graphics Extension chapter for further details on 
the Sixel format. 

Guideline: When a Sixel dump is initiated by the user under local 
control (Print Key), the terminal first transmits a CR to reset 
the ANSI text position on the printer to the left margin. If the 
Sixel dump is initiated by the' host, the CR is not sent so the 
host can initialize the starting sixel position. 
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Guideline: The VT240 sends the following characters out the 

printer port (or host port) when transmitting a sixel dump of the 
screen. 

ESC \ <CR> ESC P 1 q <sixel-data> ESC \ 

1/11 5/12 0/13 1/11 5/0 3/1 7/1 1/11 5/12 

\ ^/ \ / 

ST DCS 


7. 8. 2.1 Color And Monochrome Sixels 

On devices which support a color display, the user may select 
monochrome or color sixel printing. Monochrome Sixels are formed 
from the multiple plane image by a logical OR of all pixels which 
are selected for any color. If color printing is selected, The 
terminal will send out color specifiers at the beginning of each 
Sixel dump to reflect the contents of the terminal's color map. 

If PRINT BACKGROUND is selected, all pixels with no bits set in 
any plane are printed in the color value selected for index 0. 


\ / 

ST 


7. 8. 2. 2 Expanded Print 

Graphics expanded print mode determines whether the terminal 
generates a small (compressed) or large (expanded) graphics image. 
The small image fits on 8-1/2 inch wide paper and expanded images 
on 13 inch wide paper in portrait mode. This mode is selectable 
by the DEC-private mode DECGEPM or by the user under local 
control . 


7. 8. 2. 3 Rotated Print 

Graphics rotated print mode rotates the image by 90 degrees so 
that an expanded image can fit on a single 8-1/2 inch wide page 
(rotated images are always expanded). This mode is selectable by 
the DEC-private mode DECGRPM or by the user under local control. 

Guideline: the VT240 rotates the image counter clockwise so that 
the left side of the paper (as it comes out of a typical dot 
matrix printer) corresponds to the top of the image on the 
terminal screen. This scanning order was chosen to allow punching 
holes for a looseleaf notebook on the left side of the page as it 
comes out of the printer. 



VSRM - Printer Port Extension EL-00070-07 Page 7-60 

*** COMPANY CONF - DEC Internal Use Only 28-Apr-1987 


7. 8. 2. 4 Sixel Graphics Level (Guideline) 

As the Sixel graphics protocol has become more general to 
accommodate a range of pixel aspect ratios and grid sizes/ 
Terminals have begun supporting two levels of the Sixel graphics 
protocol to match the capabilities of the printer being used. 
Level 1 provides backward compatibility with older printers, while 
Level 2 allows the terminal to take full advantage newer printer 
capabilities to improve print quality. 

The Sixel Graphics Level determines how the terminal matches the 
printer's Sixel Aspect Ratio, Horizontal Grid Size, Background 
Printing, and Color Printing capabilities. 

The Sixel Graphics Level is selectable by the user under local 
control . 


Level 1 Sixel Devices - 

ASSUMPTIONS: Level 1 sixel devices do not support the Set Raster 

Attribute command. Background Select, Horizontal Grid Size, or 
Macro Parameter commands. The aspect ratio is fixed at 2:1, and 
the horizontal grid size is approximately 7.5 x .001 inches (800 
pixels require 6 inches). Level 1 is the factory default. 

Sixel Control Strings will be sent to the printer as follows: 

ESC P 1 q S...S ESC \ (always 7-bit controls) 


COMPRESSED Sixel Print Option - 

A terminal with a 1:1 pixel aspect ratio will combine each pair of 
horizontally adjacent pixels (from two successive scan lines) into 
a single pixel. The value of the combined pixel will be the 
LOGICAL OR of the values of the individual pixels. 
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1:1 Aspect Ratio Level 1 Printer 

+ + 

I a I 

+ + LOGICAL OR 

+ + 

I b I 

+ + 

This will produce images of the same size and aspect ratio 
as the VT240 (2:1 Aspect Ratio). 

ReGIS images will appear normal, but ANSI text 
may be distorted. 


+ + 

I I 

=> |a+b| 

I I 
I I 

+ + 


EXPANDED Sixel Print Option - 

Terminals with pixel aspect ratios of 1:1 will transmit each Sixel 
twice (in immediate horizontal succession). 


1:1 Aspect Ratio 


+ + 

I a I 

+ + 

+ + 

I b I 
+ + 


Level 1 Printer 


+ + + + 


I I 


a 


PRINT TWICE 


I 


I I I I 

+ + + + 

+ + + + 

I I I I 

I b I I b I 

III I 
I I I I 

+ + + + 


This will produce images of the same size and aspect ratio as the 
VT240 (2:1 Aspect Ratio), but with twice the vertical resolution. 


ROTATED Sixel Print Option - 

Terminals with 1:1 pixel aspect ratios will transmit the selected 
portion of the display bitmap in vertical strips six pixels wide 
from top to bottom, and right to left. 
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display 

+ + 

I 2 1 I 

I ill 

I I 11 

I V V I 

+ + 


Each Sixel is sent twice in immediate horizontal succession (with 
respect to the printer). 

1:1 Aspect Ratio 

+ + + + + + 

... I I I b I I a I 

+ + + + + + 

+ + + + 

I I I I 

+ + + + 

+ + 

I I 

+ + 


This will produce images of the same size and aspect ratio as the 
VT240(2:1 Aspect Ratio), but with twice the vertical resolution 
(with respect to the image displayed on the screen). 


Level 1 Printer 



+ + 

1 1 

+ + 

1 1 

ROTATE 

1 1 

1 a 1 

1 1 

1 a 1 

AND 

1 1 

1 1 

PRINT 

1 1 

1 1 

TWICE *> 

+ + 

+ + 

1 1 

1 b 1 

1 1 

1 1 

+ + 

+ + 

+ + 

1 1 

1 b 1 

1 1 

1 1 

+ + 


paper 



Level 2 Sixel Devices - 

ASSUMPTIONS: Level 2 sixel devices support the Set Raster 
Attribute command, Background Select, Horizontal Grid Size and 
Macro Parameter commands. 
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Sixel control strings are sent as follows: 

ESC P Psl ; Ps2 ; Pn3 q ” Pn4 ; Pn5 ; Pn6 ; Pn7 ****** ESC \ 

\ / \ / \ / \ / \ / 

DCS Protocol Selector Raster Attributes Picture ST 

data 

\ / \ / 

, DCS Introducer Sequence sixel data 

Where: 

Psl Is the Macro Parameter and is always ZERO. 

Ps2 Background Select 

1 if Background Printing is disabled in Set-Up 

2 if Background Printing is enabled in Set-Up 
Pn3 Horizontal Grid Size, given in units specified 

by ANSI SSU (default is decipoints, 1/720 inch). 

For default size units, the grid size should be 
6 for COMPRESSED and 9 for EXPANDED or ROTATED print. 
Since the host can change the printer between accesses, 
SSU should be sent once before each sixel dump. 

ESC I 2 SP I (Set Size Unit 

1/11 5/11 3/22/0 4/9 to Decipoints) 

Pn4 Pixel aspect ratio numerator, 1 
Pn5 Pixel aspect ratio denominator, 1 
Pn6 Horizontal extent 

(number of pixels in image horizontally) 

Pn7 Vertical extent 

(number of pixels in image vertically) 


COMPRESSED Sixel Print Option - 

When Level 2 sixel graphics is selected, the terminal will 
transmit the selected portion of the display bitmap as sixels from 
left to right, and top to bottom. No translation of screen pixels 
is required since the printer directly supports 1:1 sixels with 
the desired grid size. The horizontal grid size is set to 6 in 
the Set Raster Attributes command. 


EXPANDED Sixel Print Option - 

When Level 2 sixel graphics is selected, the terminal will 
transmit the selected portion of the display bitmap as sixels from 
left to right, and top to bottom. No translation of screen pixels 
is required since the printer directly supports 1:1 sixels with 
the desired grid size. The horizontal grid size is set to 9 in 
the Set Raster Attributes command. 
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I ROTATED Sixel Print Option - 

I When Level 2 sixel graphics is selected, the terminal will 
I transmit the selected portion of the display bitmap in vertical 
I strips six pixels wide from top to bottom, and right to left. 
I Each sixel is sent once using the same sixel initiator as for 
I expanded print above (horizontal grid size set to 9). 
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7.9 CHANGE HISTORY 

7.9.1 Revision 0.0 To AXIO 


1. Added Terminology section 

2. Made extensive changes to the transmission 
characteristics descriptions. 

3. Added notes that the state of Auto Print Mode is 
UNDEFINED across changes in Printer Controller Mode. 

4. Completely rewrote the algorithms for Print Line and 
Print Screen. 

5. Added note to the abstract indicating that this standard 
currently only applies to Level 2 conformance. 

6. Added a note to Printer Controller Mode indicating that 
7/15 and 15/15 are UNDEFINED when Printer Controller Mode 
is set. 


7.9.2 Rev AXIO To AXll 


1. Changed name of character rendition from REVERSE VIDEO 

to REVERSE throughout code to be more consistent. 


7.9.3 Rev AXll To AXl2 


1. Removed all previous change bars. Added change bars to 

any change that could affect conformance or 

interpretation of the document or should be brought to 
the attention of terminal implementors or software 

engineers. 

2. Defined Level 3 Printer Port Extension to document how 

multiple sessions and off screen memory interact with the 
Printer Port. Added two new Device Status Reports 

(Printer busy, Printer not assigned). Added definitions 
for "Virtual Terminal" and "Session". Extended 

description of Printer Port status. 
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3. Renamed former "Print Screen" to "Prin-t Page" (prints 
page from display memory including parts which may not be 
visible on the screen). 

4. Defined "Print Composed Main Display" or new "Print 
Screen" which prints what is displayed on the screen (may 
include data from multiple sessions). New Print Screen 
is not affected by Printer Extent Mode. 

5. Updated Print Form Feed Mode to affect both "Print Page" 
and "Print Screen". 

6. Extended description of XON/XOFF flow control (more 
complete spec). Added section on hardware flow control 
(DSR/DTR) . 

7. In printer controller mode, 7-bit Cl controls are never 
translated to 8-bits. 

8. Added description of "Local Controller Mode" to Print 
Modes (as in VT240 and VT300). 

9. Updated Printer Style modes. Documented support for User 
Preference Supplemental Set (UPSS according to TIA DEC to 
ISO 8-bit transition plan). Changed "ASCII only" to 
"National Only". In Print National + Line Drawing, noted 
how ASCII can be designated to G1 for characters not in 
current NRC (as in VT220). Modified "Print All 
Characters" mode to print all characters efficiently 
without fallback. 

10. Added table of NRC sets and designating sequences. 

11. Information on transmitting display attributes grouped 
into one section to avoid duplication. Added material on 
invisible character attribute and trailing spaces. 

12. All fallback tables grouped into one section eliminating 
duplication. Fallbacks organized by character set. 
Added fallbacks for DEC Technical, Control Representation 
Mode (CRM as in VT300), and NRCS characters not in DEC 
MCS or ISO Latin Alphabet Nr 1. Added sections 
clarifying DRCS and UPSS fallbacks. 

13. Added section describing print operations separate from 
control functions. 

14. Extended control function descriptions for Level 3. 
Updated algorithms to handle 96 character sets and new 
Print All Characters functionality. 

Added entirely new Graphics Print section which describes 
Sixel printing on terminals. 


15 . 
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Section Index 


Auto Print Mode 

control function, 7-35 
definition, 7-5 
description, 7-11 

Compressed Sixel Printing, 7-60 

Data Set Ready, 7-7 
Data Terminal Ready, 7-7 
DECPEX, 7-38 
DECPFF, 7-37 
Device Status Report 
control function, 7-32 
DSR, 7-32 

Expanded Print 

sixel, 7-59, 7-61 

Fallback Transmission 

Control Representation Mode, 
7-28 

DEC special graphics, 7-20 
DEC supplemental, 7-21 
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definition, 7-5 
DRCS, 7-28 

ISO Latin-1 supplemental, 7-23 
NRC, 7-20 
UPS, 7-28 
Flow Control, 7-6 

Graphics Printing, 7-58 
print region, 7-58 
print screen, 7-58 

hardware flow control, 7-8 

Level 1 Sixel Devices, 7-60 
Level 2 Sixel Devices, 7-62 
Local Controller Mode 
description, 7-12 

MC, 7-34, 7-35, 7-36, 7-39, 7-49 
Media Copy 

auto print mode, 7-35 
print line, 7-49 
print screen, 7-39 
printer controller mode, 7-34 
printer to host mode, 7-36 
Modes 

auto print, 7-35 


print extent, 7-38 
print form feed, 7-37 
printer controller, 7-34 
printer to host, 7-36 

NRC Sets, 7-18 

Print All Pages, 7-30 

Print Composed Main Display, 7-30 

Print Extent Mode 

control function, 7-38 
definition, 7-5 
description, 7-12 
Print Form Feed Mode 
control function, 7-37 
definition, 7-5 
description, 7-12 
Print Line, 7-31 

control function, 7-49 
definition, 7-6 
Print Page, 7-30 
definition, 7-6 
Print Screen, 7-30 

control function, 7-39 
definition, 7-6 
Printer Controller Mode 
control function, 7-34 
definition, 7-5 
description, 7-10 
Printer Port 

definition, 7-5 
Printer Port Environment, 7-9 
Printer Status, 7-8 
Printer Style, 7-13 

All Characters, 7-15, 7-16 
National Only, 7-13 
National Plus Line Drawing, 

7-14 

Printer To Host Mode 
control function, 7-36 
definition, 7-5 
description, 7-9 

Reset Mode 

auto print, 7-35 
print extent, 7-38 
print form feed, 7-37 
printer controller, 7-34 
printer to host, 7-36 
Rotated Print, 7-61 
sixel, 7-59 . 
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Session 

definition, 7-6 
Set Mode 

auto print, 7-35 
print extent, 7-38 
print form feed, 7-37 
printer controller, 7-34 
printer to host, 7-36 
Sixel Printing, 7-58 
color, 7-59 


compressed, 7-60 
expanded print, 7-59, 7-61 
monochrome, 7-59 
rotated print, 7-59 

Variable Aspect Ratio, 7-62 
Virtual Terminal 
definition, 7-6 


XON/XOFF, 7-6 
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DEC STD 070-8 VIDEO & PRINTER STANDARDS REFERENCE MANUAL - 

ReGIS GRAPHICS EXTENSION 

Document Identifier; A-DS-EL00070-08-0 Rev A, 31-Mar-1988 


ABSTRACT: This standard defines the REmote Graphics Instruction 
Set (ReGIS). ReGIS is a set of graphics execution instructions 
designed primarily for graphics terminals operated over low 
bandwidth communications paths, such as serial lines. 


APPLICABILITY; Mandatory for Engineers designing hardware for 
terminal products and Software Engineers designing programs using 
or emulating terminal interfaces. Additional requirements are 
defined in the section on "Concepts and Conformance Criteria." 


STATUS; APPROVED 31-Mar-1988; see EL-INDEX-00 for expiration date. 
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8.1 INTRODUCTION 

8.1.1 PURPOSE 

This standard specifies a data representation for the device 
independent description of a certain class of imagery called 
synthetic graphics. "Synthetic graphics" is a term used to 
describe a mode of drawing in which images are defined in terms of 
component parts. These parts may be synthesized from geometric 
entities such as lines, circles, points, and uniform areas. 
Synthetic graphics differ from "natural imagery" in that "natural 
images" are usually derived photographically and stored in dot 
matrix or some other pixel oriented form, and contain only limited 
explicit information regarding their component content. The 
REmote Graphic Instruction Set (ReGIS), a generic graphic 
descriptor, is the system described for executing the graphics 
commands . 

8.1.2 SCOPE 

This standard achieves the above purpose by; 

1. Postulating a system model based on current technology in 
which graphics can be supported; 

2. Identifying commonly required access points into this 
model, and; 

3. Specifying an execution model and instruction set (ReGIS) 
consistent with this model. 


8.1.3 IMPLEMENTATION OF ReGIS 

It is not the intent of this standard to specify what products, 
hardware or software, must implement ReGIS. The decision to 
support ReGIS or not will be made by the appropriate marketing and 
engineering organizations during the initial stages of the Phase 
Review Process for the product(s) in question. This standard 
defines the function and form which must be implemented in a 
product for it to be certified as conforming to ReGIS. 

ReGIS can be implemented as either a hardware or a software 
product; any products which generate or interpret ReGIS are within 
the scope of this standard. 
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8.1.4 REFERENCE STANDARDS AND RELATED PUBLICATIONS 
DIGITAL STANDARDS 

EL-00138-00 DEC STD 138-0 Registry of Control 

Functions for Character-Imaging Devices 

EL-00169-00 dec STD 169-0 Digital Standard Coded 

Graphic Character Sets for Hardware 
and Software 

Copies of Digital Standards Can be obtained from Standards and 
Methods Control, CTS1-2/D4, DTN 287-3724, JOKUR::SMC 

Please provide your name, badge number, cost center, mailstop, and 
ENET node when ordering. 


ANSI and ISO STANDARDS 

ANSI X3.4 - 1986 American National Standard Code for 

Information Interchange (ASCII character set) 

ANSI X3.41 - 1974 American National Standard Code Extension 

Techniques for use with the 7-Bit Coded 
Character Set of the American National 
Standard Code for Information Interchange 

IS2022-1986 Information Processing - ISO 7-bit and 8-bit 

Coded Character Sets - Code Extension Techniques 

(unnumbered) ISO Register of Coded Character Sets 

for Use with Escape Sequences 


ANSI X3.64 - 1979 Additional Controls for use with American 

National Standard Code for Information 
Interchange 

ANSI X3. 122-1986 ( IS8632-1986 ) Computer Graphics Metafile 
ANSI X3. 124-1985 ( IS7942-1985 ) Graphical Kernel System (GKS) 


Copies of ANSI and ISO Standards and other related publications 
can be obtained from local Digital Libraries. 

"Computer Graphics" vol 13, number 3 (August 1979) - GSPC CORE 

proposed graphics standard 
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8.1.5 TERMINOLOGY 


Absolute Location - An unsigned coordinate pair that specifies a 
location based on the screen origin. 

Active Position - The character position on the visual display at 
which the next graphic character would (will) be displayed. 

Application Free Primitives - A ReGiS-implemented set of drawing 
primitives based upon common geometric rule and compass 
constructions. It contains basic, general constructions 
only, not specific capabilities for particular applications. 

Base Logical Device - See Logical Graphics Device. 

Bracketed Pair ([]) - A pair of quantitative values enclosed in 
brackets; used in ReGIS command strings to encode position 
values and other position or extent related information. 

Closed Curve Sequence - A series of locations ReGIS uses to 
interpolate a curve whose end points meet. One example is a 
circle . 

Command Keyletter - The ReGIS syntactic element which indicates 
that a command or command option is to be interpreted. 

Complement Writing - Writing mode in which ReGIS complements the 
image existing on the display with new images being written 
to the screen. 

Current Location - The location in the display space last moved or 
drawn to. 

Display Surface - The active area of the screen; it may be the 
entire screen. 

Echo - Retransmit encoded messages back to the sending device as 
they are sent. 

I Erase Writing - Writing operation which overwrites previously 
I drawn objects from the display by using the background 

I (secondary) writing value for both primary and secondary 

I writing values. 

Filling - Coloring in a bounded area as it is defined; contrast 
with "flooding" and "shading". 

Flooding - Coloring in, with variable pattern or texture, a 
bounded area already defined in the display. Supported only 
by extension to ReGIS. 
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Graphic Character - A character, other than a control character, 
that has a visual, displayable representation. 

Graphics Cursor - A visible indicator of the current drawing 
position. 

Graphics Pipeline - Graphics environment models are often layered, 
with higher level layers requesting services of lower levels 
to effect actions. The route(s) through these layers is 
called the "graphics pipeline." 

Graphic Text - Strings of characters drawn by executing graphics 
commands; these are distinguished from other types of text by 
the use of state stored by previous graphics commands. 

Gray Scale - The range of varying levels of light displayable by 
black and white raster graphics devices. High resolution 
color raster devices can display the gray scale in addition 
to a full range of color hues. 

HLS - Hue, Lightness, Saturation. A three-parameter system for 
describing a color based on human perceptual description of 
color . 

Landscape Mode - The rectangular viewing area with the X 
(horizontal) axis as the longer one. 

Logical Graphic Device - An abstract graphic device for which 
ReGIS defines an image. This abstract device is a composite 
of a wide range of physical devices, and is used as a 
hypothetical basis for the ReGIS device interface. Allowable 
exceptions to the Base Logical Graphic Device are provided 
for in the Extended Logical Graphic Device. 

Line Pattern - Line styles or drawing patterns (solid, dashed, 
dotted, etc.) defined and supported by ReGIS. 

Macrograph - A series of ReGIS commands or command elements that 
are stored as part of the ReGIS implementation state and 
invoked on request by a named string. Macrographs reduce 
communication line traffic between the terminal and computer 
in the case of frequently used commands. Concept derived 
from the assembly programming construct of macro 
instructions . 

Offset - A distance from a given reference location. 

Open Curve Sequence - A series of points interpolated by ReGIS to 
draw a curve whose end points do not meet. 

Overlay Writing - Writing mode in which only the foreground 
(primary) writing value is executed into the display, and the 
background (secondary) writing value is not used. Contrast 
with "replace writing." 
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Pixel - Picture element; the smallest displayable unit on the 
screen. 

Pixel Vector - A scalable unit vector whose direction is parallel 
to an axis or to a diagonal between the axes. 

Portrait Mode - A rectangular viewing area with the Y (vertical) 
axis as the longer one. 

Position Address - A specific point in the viewing area of a 
graphic device that is representable by an X-Y 
(horizontal-vertical) pair of numbers. 

Protocol - The conventions or rules for the format and timing of 
messages sent and received. Devices must be using the same 
protocol to understand each other. 

Raster Device - A display device that generates images using a 
raster scan. 

Raster Scan - In computer graphics, a technique of generating or 
recording the elements of a display image by a line-by-line 
sweep across the entire display surface; for example, the 
generation of a picture on a television screen. 

ReGIS - Mnemonic for REmote Graphics Instruction Set; a set of 
graphics object description commands. 

Relative Location - A point on the screen measured from the 
current location rather than the screen origin. 

Replace Writing - A ReGIS writing mode in which both foreground 
and background values are written to the display medium; 
contrast with "Overlay Writing." 

Reset - Return to a known default condition. 

I Shading - An area fill operation that fills the area between a 
I vector or curve and a specified horizontal or vertical line 

1 or a point. Shading differs from FLOOD and FILL in that it 

colors in a solid or textured area which is not explicitly 
bounded. 

Sixel - A coined term derived from "six pixels." Sixels are an 
image transfer mechanism in which six pixels of information 
are encoded into a single character code. Sixels may be used 
as an image re-transmission scheme from ReGIS. 

Transportability - The capability of carrying ReGIS-def ined images 
across device technologies without loss of critical 
information. 

Viewing Point - See Pixel. 

I 

I Writing - The operation of executing graphics to the display 
I medium. 
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8.1.6 MODELING THE GRAPHICS SYSTEM 

The Remote Graphics Instruction Set (ReGIS) is intended to be used 
for device level portable graphic image definition. ReGIS is 
meant for the communication of graphic images between a host 
computer and a remote graphics device. It has applicability to 
tightly coupled graphics systems in any context in which a graphic 
image can be stored in geometric component form encoded as a 
sequence of characters. ReGIS is not intended for use in high 
performance graphics applications where picture complexity is 
great or where texture and graded shading are required. 

8. 1.6.1 The Graphics Pipeline 

The state of the art in computer graphics layers the graphics 
environment in a manner very much like the way networks and 
communications models are layered. In layered models, higher 
level layers request services of lower levels to effect actions. 
Traversing these layers is known as proceeding through the 
graphics pipeline. 

Existing proposals postulate levels for modeling of graphics 
information and performing viewing operations on the data 
represented in these models. The level of graphics execution is 
added to these levels. It is this level that most closely 
approaches the capabilities of existing graphics devices (as 
opposed to systems), and it is to this level that ReGIS is 
directed. 
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8. 1.6. 2 The System Model 

Figure 8-1 illustrates the assumed general block diagram of the 
graphics system for which ReGIS was designed. As illustrated, the 
system consists of two major parts: (1) the host computer system, 
which from the user's point of view consists of various software 
modules and (2) the remote graphics device. The term "remote" 
here refers to the assumption that the graphics device is attached 
to the host computer by a possibly low-speed communications link. 

The host computer system is assumed to consist of four major parts 
(not all of which may be present in any particular system); 

1. Graphics application package - Such packages allow the 
user to access the graphics capabilities of the remote 
device in terms of syntax and semantics appropriate to 
the user's intended application. For example, a data 
plotting package may accept tables of data and allow the 
user to construct plots of varying types based on that 
data, using an interaction dialog appropriate to the 
application. 

2. High level language - Users often need to generate 

graphic images of significant complexity requiring 
algorithmic definition, or images requiring dynamic 
changes. Such programs are generally written in higher 
level languages which may or may not have direct access 
to graphics functionality. 

3. Text files - Sometimes called the graphics "metafiles"; 

static storage of the definition of a graphic image 

allows later use of that graphic image in the same manner 
as printing out a report file of standard text. 

4. Operating system - The operating system may provide 

support to the graphics user in the general case by 
converting the graphic image definition provided by the 
other software to the required protocols necessary to 

drive one or more remote graphics devices, or may use 
graphics directly to implement a pictorial (iconic) 
dialog with the user. 
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8. 1.6. 3 Graphics Language Access Points 

Based on the above assumed structure, the system has at least six 
language access points of interest to the users and developers of 
such a system: 

1. Graphics application languages - such as plot commands in 
a data plotting package or the constructors of physical 
images as represented by the Graphical Kernel System 
(GKS) graphics standard. 

2. High level languages - allow access to graphics semantics 
in three possible ways; 

a. By direct drive of character based communication 
protocols by using string constants output through 
"PRINT" statements 

b. Through graphics subroutines accessed by programmed 
calls 

c. Through embedded graphics statements accessed in the 
same manner as other language capabilities 


3. Graphics text files - the syntax of how the graphics 
image is stored as text for later communication to the 
graphics device (metafiles). 

4. Communications Interface - the syntax of the graphics 
commands sent sequentially to the graphics device. 

5. Graphics hardware instructions - the (presumably digital) 
signals generated by the local device processor to 
control the hardware image generator. 

6. User graphics entries - the specialized entry sequences 
for local control in addition to the syntax of the user 
commands required to use the application software 
programs . 


8. 1.6. 4 ReGIS Scope of Application 

Considering the breadth of graphics applications and the 
differences in "personality" between the different language 
points, it is not feasible to identify or specify one instruction 
set which satisfies the requirements of all access points in the 
system. On the other hand, the relatively large number of 
different graphics language syntaxes of which a user may have to 
be aware predicates a few standardized language approaches, with 
special languages applied when dictated by the application. These 
latter special applications must be based, where possible, upon 
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other existing standards. It is the purpose of ReGIS to 
standardize the syntax and semantics of the communications 
interface graphics commands. By extrapolation, it is also 
intended that ReGIS be used at other graphics language access 
points at which a character based descriptive representation of 
the graphic image is appropriate. In summary then, it is intended 
that ReGIS be used for the following graphic language access 
points for both remote and closely coupled graphics systems: 

a. Graphics instruction string constants from high level 
languages, whether generated by print statements or the 
compilation of high level language programs having 
embedded graphics statements 

b. The "semantic protocol" for graphics access across a 
serial communications line to a remote graphics device 

c. The syntax of graphics commands when stored in a 
character oriented file 


8.1.7 RANGE OF INTENDED DEVICES 

ReGIS attempts to cover a broad range of both soft-copy (temporary 
record) and hard-copy (permanent record) remote graphics devices. 
ReGIS executes well-defined, two dimensional, descriptively 
encoded graphics images. The technology of a device is generally 
not a factor in the determination of whether that device would be 
suitable for an implementation of ReGIS. 

The principal requirement for transporting ReGIS-def ined images is 
that the essential information content of an image MAY be encoded 
in the basic set of ReGIS instructions so that little, if any, 
essential information content is lost. This must hold true if 
attributes of one device are transformed, or even ignored, by 
another device which does not have that particular attribute 
capability. 
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8.1.8 ReGIS OVERVIEW 

Good design practice specifies the function set of a proposed 
interface before selecting an encoding to implement it. However, 
the primary operational environments of ReGIS are required to be: 

a. Serial communication channels operating under existing 
text-oriented protocols, and 

b. Text-oriented data storage for deferred execution of 
pictures. 


These design constraints make it feasible to define the function 
set of ReGIS and its encoding concurrently. As a consequence, the 
function set of ReGIS is defined in this standard in terms of its 
encoding, both syntax and semantics. 

ReGIS instructions are sequences of characters based upon the 

alphabet common to most computing systems. This alphabet consists 
of letter, digit, and punctuation characters. A graphic image is 
drawn by sending the graphics device a sequence of instructions 
encoded into this alphabet. The general format of each 

instruction is a keyletter denoting the type of operation to be 
performed, plus instruction arguments which have a prescribed 
meaning when associated with a keyletter. The nine basic 

(keyletter) instructions in ReGIS are briefly defined as follows: 

1. Screen Instruction - keyletter "S" - Screen operations 

affect the entire visible viewing area. Actions include 
setup of the display space, clearing the display in 

preparation for a new image, and controls which may 
affect the re-direction or retransmission of an image. 

2. Writing Attributes Instruction - keyletter "W" - Write 

Attribute instructions are modifiers which affect the 
actions of drawing instructions following them. 
Attributes include line style, color and intensity, 
patterns and textures, and other image modifiers. 

3. Position Instruction - keyletter "P" - The Position 

instruction causes the drawing process to commence or 
resume from a specific position in the drawing area. 

4. Vector Instruction - keyletter "V" - The Vector 

instruction invokes the line primitive causing straight 
lines to be drawn between positions specified by the 
instruction arguments. 

5. Curve Instruction - keyletter "C" - The Curve instruction 
causes circles, arcs, or general curve images to be drawn 
based upon the arguments of the instruction. 
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6. Text Instruction - keyletter "T" - The Text instruction 
causes a sequence of text characters to be drawn in a 
manner based upon the arguments of the instruction. 

7. Report Instruction - keyletter "R" - The Report 

instruction allows state information to be returned to 
the host from the ReGIS implementation. 

8. Fill Instruction - keyletter "F" - The Fill instruction 
allows linear elements (lines and curves) to be used as 
boundaries for simple or complex closed areas, which can 
then be "colored in." 

9. Load character cell Instruction - keyletter "L" - The 

Load character cell instruction allows ReGIS programs to 
define character patterns for use in the Text instruction 
and general character patterns that are used in area 
operations . 

There are four general types of arguments used in ReGIS: 

1. Position arguments are strings of characters written 
within the bracket characters "[" and "]". Bracketed 
position specifiers are used as effective addresses or 
address increments. 

2. Text strings are character sequences contained within 
paired quote characters, either ' or ", and are used when 
a character is itself an argument of an instruction, as 
in the case of the Text instruction. 

3. Digits are interpreted as numeric values, decimally 
encoded binary values (as logic masks, and so on), or 
addresses of adjacent neighbors of a given point in a 
display. 

4. Option arguments are strings of characters written within 

the parenthesis characters "(" and ")" which in some 
manner modify the way in which the instruction carries 
out its intended purpose. The syntax of the option 
strings is the same as for instructions and for this 
reason, option arguments are also called 

sub-instructions . 


These basic instructions and their arguments are sufficient to 
define most of the information of most graphic images required by 
users of graphics systems. 
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8.2 ReGIS PHILOSOPHY 

This section describes and discusses the rationale of ReGIS in 
terms of: 


1. The approach of allowing an image originally defined for 
one graphics device to be drawn on a dissimilar graphic 
device, called the instruction set "transportability"; 

2. Concepts of the instruction syntax and the orientation to 
the ASCII character code conventions; and 

3. Concepts of handling dissimilar device attributes and 
capabilities, referred to as the "semantics" of ReGIS. 


8.2.1 TRANSPORTABILITY CONCEPTS 

The goal of image definition transportability is to enable a given 
sequence of graphic instructions to draw similar looking images on 
dissimilar graphic devices. There are three major aspects of the 
design of ReGIS which enhance transportability. These are: 

1. Application free primitives 

2. A mandatory base implementation 

3. Imposition of critical device parameters 


Note that complete transportability depends on the user selecting 
features of a device that are possible to transport across 
technologies without loss of critical information. For instance, 
ReGIS cannot preserve the information content encoded as blinking 
when the commands are transported to a hard-copy device. 

8. 2. 1.1 Application Free Primitives 

ReGIS implements a set of drawing primitives based upon common 
geometric rule and compass constructions, and does not contain any 
specific capabilities which can be interpreted in terms of the 
semantics of the application. For example, ReGIS does not include 
viewing transformation, hidden line removal, and other 
capabilities generally useful in presenting images of real 
physical things. Neither does it have built-in axis and bar graph 
primitives which would be used to support only data plotting. 
Instead, this model assumes that these capabilities are adequately 
supported at higher levels in the graphics pipeline, and that 
these functions are encoded into a sequence of ReGIS instructions. 
In this way, ReGIS does not burden one application with features 
required specifically for another. 
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8. 2. 1.2 Mandatory Base Implementation 

ReGIS instructions are based on a general instruction syntax which 
all devices are required to parse. 

Every device using the ReGIS instruction set must completely 
interpret all possible character sequences defined by this general 
Instruction grammar, whether or not those character sequences have 
semantic meaning in the device in question. The syntax of ReGIS 
is complete and well formed. Only the semantics can vary among 
devices of differing capabilities, and, at that, only among 
extensions to the most fundamental required instruction set. 

Semantically, ReGIS instructions and parameters are separated into 
I a Base ReGIS category, a Raster Extensions category, and Open 
I Extensions. Other extensions may be defined to apply to other 
I technologies or categorizations. It is assumed that most of the 
essential information content of any desired graphic image may be 
defined by the Base ReGIS instructions and parameters. All ReGIS 
based graphic devices must accurately interpret these Base 
capabilities. 

In addition, users expecting to output the defined images to a 
variety of devices should use only the Base ReGIS capabilities to 
ensure maximum transportability. For example, color is not a 
common attribute of every graphic device, and for this reason the 
ReGIS Base is "color-blind". Users desiring maximum 
transportability should avoid using color to relate essential 
information where that same information is not also implied by 
monochrome boundaries or patterns. 

There are several possible categories of Standard Extensions to 
ReGIS. These extensions are based on differences in technology, 
and are used to standardize device features across the class of 
devices represented by that technology. The most important 
extension class is for raster scan display devices, including 
color CRT displays. Standard extensions for a given class of 
device allow all devices within that class to be controlled in a 
class dependent, yet device-wi thin-class independent manner. 
Hence, all raster devices must implement the full range of the 
standard Raster Extensions. 

This concept works, and even allows commands from an extension set 
to work on simpler devices, because all devices must fully parse 
the general instruction syntax. Therefore, a capability in one of 
the extension sets is simply ignored or transformed to an 
alternate attribute in a device for which that capability does not 
exist. 

This approach is feasible because of the small number of syntactic 
elements in ReGIS, and their ease of identification. 
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8. 2. 1.3 Critical Device Parameters 

The third major concept in allowing maximum image transportability 
is the use of critical setup parameters defined once for each 
image and placed at the beginning of the instruction sequence for 
that image definition. Thus, in the worst case, the user might 
have to adjust these parameters to achieve maximum fidelity in the 
reproduction of a graphic image. As an example of such a critical 
device parameter, ReGIS allows the user to set the range of (X,Y) 
coordinates to be used for an image definition. These should be 
set to the actual physical range values of the device which the 
user most often accesses. These range parameters could be 
adjusted to maximally utilize a dissimilar low resolution device 
but would not have to be adjusted for displaying the same image on 
a high resolution device. 

Imposing expectations on the device departs from what has been 
common practice in graphics and other areas of computer peripheral 
access. Commonly, devices are interrogated for their function 
sets and features, and the applications take on the burden of 
manipulating data to fit the device. By placing the burden of 
accommodation on the device, the application or picture file 
becomes more portable and less likely to require modification as 
new devices or classes of devices come into use. 

8. 2. 1.4 Fidelity of Information Presentation 

Devices must be allowed varying levels of fidelity in the 
presentation of information implied by ReGIS instructions. This 
is a reflection of differences in technology and engineering 
constraints in product implementations. Fidelity may be measured 
in a qualitative and quantitative sense. Qualitatively speaking, 
a line is a line because it appears to connect two points in the 
display in a continuous fashion. A circle is a circle because it 
is "round." These aspects of fidelity are, in part, subjective. 
Pixel oriented devices actually draw lines as a sequence of 
intensified dots, and the ragged nature of some lines is entirely 
unpleasant in some instances. However, even these less than 
perfect lines are, qualitatively speaking, lines. 

When fidelity is measured quantitatively, some features of some 
systems cannot be satisfactorily transported. Display resolution 
varies from device to device, and the capacity of a display in 
terms of discernible line pairs or character cells will vary, as 
will capacities of character cell stores or attribute memories. 
Where such limits can be quantitatively described, they will be 
specified with the appropriate instructions as guides to 
transportability. 

Lower resolution and/or monochrome devices by their nature have 
limited information presentation capacity. Drawing a very 
detailed image whose information content exceeds the information 
capacity of the target device may result in essential information 
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being lost. These devices may conform to the ReGIS standard if 
the qualitative judgement is that they will serve to display 
images which preserve "enough" information content for normal use. 
While this definition may appear quite open and perhaps circular, 
it is a pragmatic and workable one when the decision as to whether 
ReGIS is the appropriate graphics support mechanism is 
well-founded. Higher resolution devices may be expected to 
implement the highest degree of fidelity of information 
presentation. 

Transportability is achievable if images are prepared on lower 
resolution devices for later output on higher resolution devices, 
or that a high information content image is prepared directly for 
the high resolution device. It is not expected that an image 
prepared on a high resolution device will be drawn on a 
substantially lower resolution device, except perhaps for "quick 
checking." Should this situation exist, however, the user must be 
willing to accept the possible misinterpretation of information as 
a result of the lower fidelity of reproduction. 
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8. 2. 1.4.1 Guidelines for Image Creators 

Given the above, the user must bear some of the burden for 
balancing the devices available and the applications in mind. If 
transportability is a goal, then appropriate consideration must be 
given to the range of devices that may be encountered; the 
complexity of the presentation should be tailored to that 
environmental range. For this reason, device or technology 
specific features should be used only where they are absolutely 
necessary, or when transportability is not a goal. Even though 
they are supported through ReGIS, special features cannot be 
guaranteed across all devices. 

There are certain specific methodologies image creators can adopt 
to enhance the transportability of images. This list is not 
exhaustive, but should serve to lead the reader's thoughts in the 
direction that will allow for accommodation of device differences. 

a. Do not use expected device resolution to encode maximum 
information content into an image. While the most 
aesthetically pleasing results can often be obtained by 
planning patterning, character cell placement, and the 
like based on the pixel resolution of known devices, such 
attention to detail builds into an image a dependency on 
resolution that precludes image transportability. 

b. Specify text character sizing in terms of the imposed 

address space using the expanded Text commands for Unit 
{T(U[])} and Display {T(S[])) cell sizes rather than as 
multiples of standard size {T(S<n>), T(H<n>)}. The 

definition of standard sizes has been a concession to 
device dependency, and the inability of devices to 

smoothly scale or otherwise provide for variable text 
sizing. While such hardware considerations are not 
entirely moot, it can be expected that as device 

resolutions increase and windowed displays come into 
wider use, the ability of devices to better couple 

graphics drawing elements and descriptive text will be 
enhanced. 

c. Select colors descriptively using RGB or HLS 

parameterization rather than by index value. Index 

values wrap and collide in a manner dependent upon the 
number of index values supported, and probably without 
any attention to the perceptual flavor of what is being 
specified. Collisions between descriptive colors are 
defined in this standard to merge similar colors (red and 
orange or red and pink, for example) to some common color 
("closest match"). Dissimilar colors (blue and yellow or 
orange and green, for example) are less likely to collide 
in a single common color, thereby maintaining perceptual 
separation. 
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d. Perhaps most importantly, use the imposition of 
coordinate address space to define the expected device. 
The use of device inquiry and accommodation of device 
differences in software is not the best way to ensure 
transportability. Such an approach cannot easily be 
applied to stored files, as it places a burden of 
re-interpretation of the file on the image transfer 
system. 

In windowed systems, the actual physical granularity of a 
display may not be known to driving software, or it may 
change dynamically in a way that cannot be conununicated 
to driving software. Also, accommodation by inquiry 
requires that software try to guess what future 
implementations will do • to enhance or subset present 
devices . 

Device developers have the advantage of hindsight with 
regard to what features of devices software has used, and 
in what combinations, and can thus make future devices 
compatible with existing software, rather than having 
software try to anticipate, perhaps inconsistently, the 
direction future hardware will take. 


8. 2. 1.4. 2 Guidelines for Image Interpreters 

Device developers can minimize the problems that software will 
encounter in pursuing the goal of transportability. 

1. First and foremost, device developers should be guided by 
the past. Various ReGIS implementations must be 
syntactically and semantically compatible and minimize 
non-functional changes from one product to the next. 
"Non-functional" changes mean capricious changes in 
device parameters that this standard allows developers 
the freedom to define, but which have minimal impact in 
the details of device design. For example, one might 
argue that all devices with less than 1000 addressable 
points in the horizontal dimension should have exactly 
800. While the "Guidelines for Image Creators" above 
recommend that software not depend on pixel level 
registration for images, small changes in resolution, as 
from 800 to 768 pixels across, can result in 
significantly different screen presentations. 

2. Hardware address spaces should be isotropic, meaning that 

equal increments of physical addressing quanta 

horizontally and vertically should translate to the same 
measured distance. ReGIS requires that the imposed 

coordinate space be treated as isotropic, and the device 
must mask any variation from the 1-to-l pixel aspect 
ratio. It may not be possible to hide the aesthetic 
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effects of such mismatches, however. Consider that 45 
degree rotation of text is generally deemed an "easy" 
case. Deviations from 1-to-l (or at least integrally 
related) pixel aspect ratios make this case either 
difficult to execute or unaesthetic. 

3. The most visible departure from fidelity in image 
transportability does revolve around character handling. 
Variables relating to character storage size, standard 
sizes, and scalability should be scrutinized carefully 
for effects on software and existing imaging practice 
before they are changed. As with other aspects of 
"non-functional" change, any resulting variations should 
be based on significant improvement in capability, not 
just for incremental iMprovement. 
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8.2.2 SYNTAX CONSIDERATIONS 

8. 2. 2.1 Character Codes 

All ReGIS commands may be formed from characters in columns 2 
through 5 of the ASCII code chart. It may be considered, in light 
of strict interpretation of ANSI character set and coding rules, 
that ReGIS is a violation of the use of printing character codes 
for commands. This compromise achieves two goals: 

1. To allow an encoding more terse than that required by 
existing control code standards (ANSI X3.41 and ANSI 
X3.64) 

2. To develop an instruction set which could be easily 
generated, stored, and interpreted 

As a matter of convention, ReGIS is defined in terms of upper-case 
letters with the understanding that lower-case letters are 
equivalent to upper-case for command interpretation. Lower-case 
letters remain lower case within quoted string arguments, however. 

8. 2. 2. 2 7-bit Versus 8-bit Encoding 

The ReGIS command syntax and semantics are specified for use in a 
7-bit coding environment, though provision has been made for the 
support of 8-bit encoding of character arguments. See subheadings 

8.4.3 Argument Types, 8. 4. 3. 2 Quoted Strings. Support of ReGIS 
command codes in an eight bit environment is an environmental 
issue, and is not addressed in this standard. 

8. 2. 2. 3 ASCII Control Codes 

ReGIS does not specify the use of any ASCII control codes, except 
for certain occurrences within quoted text strings. Any controls 
or control or escape sequences passed to a ReGIS interpreter are 
I not required to be recognized or parsed by the interpreter!*]. 
Such controls may be included in a ReGIS data stream for purposes 
of control of the system or device in which the interpreter is 
running (such as XON/XOFF for communications synchronization or 
escape or control sequences to activate or deactivate the ReGIS 
interpreter) but the recognition and interpretation of such 
sequences is not required by this standard for conformance. 


(*]Some devices find it appropriate to scan for and parse escape 
and control sequences while interpreting ReGIS. Some of these 
devices execute escape sequences as if they (the devices) were not 
in ReGIS mode, and return to ReGIS mode after such execution. 
Other devices use the occurrence of any escape code (code position 
1/11 or 8/* or 9/*) as reason to exit the ReGIS mode. Such use 
may be necessary to support non-conforming software, but such use 
is deprecated by this standard. 
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8. 2. 2. 4 Linguistic Relationship to Higher Level Languages 

The ReGIS general syntax is based on a simple, easily parsed 
grammar. This grammar can be easily generated by common high 
level languages and user application packages. Also, the ReGIS 
instructions encompass most, if not all, of the graphics 
primitives required to support the execution of graphics 
constructs required by higher level graphics applications 
packages . 

The encoding of ReGIS instructions and arguments is such that the 
use of ReGIS directly in the PRINT or WRITE commands of such 
languages as BASIC, FORTRAN, and Pascal is practical and 
straightforward. The representation allows reasonably qlear, 
although admittedly terse, coding. In particular, numeric 
arguments are encoded as the usual decimal integer, fixed point, 
floating point, and scientific notation strings generated by these 
languages . 

8.2.2. 5 Algorithmic Relation to Higher Level Languages 

ReGIS is not meant to be a language in its own right. ReGIS has 
no algorithmic structures, such as conditional or loop constructs, 
no general arithmetic capability, and no named variable storage. 
All these features are presumably present in the higher level 
languages from which ReGIS may be used for the encoding of 
pictorial information. 

8. 2. 2. 6 Communications Line Efficiency 

The level of ReGIS instructions is set high enough so that 
reasonable performance can be obtained even at low transmission 
rates. A relatively few command characters can invoke fairly 
complex graphics activity. The "macrograph" construct is included 
in the ReGIS Base to allow string sequences to be transmitted 
once, stored locally, and then referred to by name for subsequent, 
repeatable invocation. 

ReGIS is generally free format and requires no instruction 
separators, thereby allowing multiple instructions per "line." In 
fact, ReGIS has no awareness of line boundaries, since ASCII 
control characters are ignored (except for a few instances, and 
only within quoted string arguments). 
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8. 2. 2. 7 High-level Language "Personality" 

Although it is not possible to define a completely compatible 
personality among all higher level languages, ReGIS has attempted 
to capture the essence of the personality of many higher level 
languages to allow the most rapid learning by users with minimal 
corruption of well-known syntactic constructs. Common numeric and 
string constant constructs, the ignoring of blanks and 
auto-conversion of lower case to upper case are examples of the 
implementation of this concept. 

8.2.3 SEMANTIC CONSIDERATIONS 

8. 2. 3.1 Range of Devices 

The ReGIS Base defines a logical graphics device modeled after a 
composite of existing and envisioned graphics execution devices. 
The common capabilities of flat bed and rotary plotters, storage 
tube devices, raster video and hard-copy devices, and other 
devices were evaluated in the definition of the command complement 
of ReGIS. The ReGIS Base defines a common denominator of these 
devices, and the Extensions categories are defined to access the 
unique capabilities of these and other graphics devices. 

8. 2. 3. 2 Position Addressing 

A specific point in the viewing area of a graphic device is 
assumed to be representable by an (X,Y) (horizontal-vertical) pair 
of numbers. It is also assumed that the viewing area is 
rectangular in shape for the purpose of code transportability. 
The size of an address increment is defined by the coordinate 
space as imposed by the device setup, or by device default if this 
setup is not used. 

8. 2. 3. 3 Semantic Defaults 

In the ReGIS Base, all parameter ranges required by a device are 
derivable from user supplied screen coordinates. These are 
transformed to physical coordinates by the device. An exception 
to this is the size of "standard characters" in the device. These 
are typically constrained by the physical design of the device. 
To accommodate such variances, ReGIS allows the user to "adjust" 
some of these parameters so that the actual visual result is as 
close as possible to what is desired. Such adaptations may 
require user intervention (that is, trial and error) to reproduce 
picture content accurately. 

Devices that implement ReGIS extensions are required to implement 
default values for all such semantic features that affect the 
visible display. These defaults must approximate, to the degree 
possible, the visual impression of the image on a device without 
these visual enhancements. These defaults must be assumed each 
time the screen addressing operation, S(A[][]), is performed. 


TM 


Digital Internal Use Only 



EL-00070-08 31-Mar-1988 

VSRM - ReGIS GRAPHICS EXTENSION 


Page 8-32 


8.3 BASE LOGICAL GRAPHIC DEVICE 

ReGIS defines an image for an abstract graphic device called the 
ReGIS Logical Graphic Device. In principle, this abstract device 
is a composite of a wide range of physical devices. Features 
unique to specific types of physical devices are part of the 
extended ReGIS logical device and are discussed in later sections. 
An image defined for one physical device is transportable to a 
different type of physical device. However, feature extensions 
may be ignored or approximated on some devices. Therefore, exact 
duplication of an image may not always be expected when image 
definitions are so transported. It is not expected that any one 
specific device have the parameters of the logical device, but 
rather each ReGIS based physical device maps (transforms) the 
parameters given in terms of the logical device to its specific 
physical parameters. 

The ReGIS logical device is defined in terms of: 

a. Parameters of the viewing area. 

b. Attributes of viewing points in the viewing area. 

c. The general process of defining an image in the viewing 
area by modifying the attributes of the viewing points; 
interpretation of ReGIS is a serial process, and the 
visible portions of the image are drawn in the order in 
which the instructions are received. 

d. The allowed range of parameters and attributes. 


The phrase "implementation dependent" refers to a parameter or 
attribute value that has a semantic meaning which may vary with 
the type of physical device or because of other implementation 
constraints. The allowed range of variance for an implementation 
dependent feature is included with the discussion of that feature 
in this standard. 

The physical embodiment of the Logical Device is not presumed by 
this standard. The Logical Device may be represented by a single 
physical device, or it could, in fact, be a subset of a single 
physical device comprising a number of independent Logical 
Devices. In the latter case, the viewing area (and other physical 
device resources) available to a particular Logical Device are but 
a fraction of the whole of the physical device. In either case, 
the view of the Logical Device as seen through ReGIS is that of a 
single, independent presentation entity having no effect on and 
not being affected by any other device. 
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8.3.1 VIEWING AREA DEFINITION 

The ReGIS Logical Device viewing area consists of a rectangular 
grid of a finite, possibly large, number of viewing points. Each 
viewing point is of finite area and is located at the intersection 
of the invisible lines of the two dimensional Cartesian coordinate 
grid. Usually, a viewing point is the smallest physical area with 
homogeneous structure that can be seen by the viewer. This 
viewing point corresponds to the smallest area which can be 
modified by the physical device. 

This area has historically been referred to as the "screen." 
Because of the connotation of "video" in the use of the term 
"screen," modern practice uses the term "display surface." Both 
terms are used in this document. Mathematically, the display 
surface may be thought of as a set of viewing points such that the 
union of all viewing points completely covers the viewing area. A 
viewing point may also be referred to as a picture element or 
"pixel." 

When the screen is rotated so that the image has its "normal" 
orientation, then the four edges of the rectangular screen are 
called the left, right, top and bottom edges. The terms 
horizontal and vertical are used to refer to pixel positions 
relative to these four sides. The position of each pixel on the 
screen is uniquely identified by the combination of two numbers 
which refer to the horizontal (or X) position and the vertical (or 
Y) position of the pixel. Using this, the pixel VP(X,Y) refers to 
the Viewing Point at the horizontal value denoted by the number X 
and at vertical value denoted by the number Y. 

This model of addressing the view surface centers pixels on their 
enumerated coordinates. A different device model places pixels 
between coordinate values. Device implementors are allowed to 
exercise certain freedoms in mapping the coordinate enumeration 
scheme used by their devices to that of the ReGIS Logical Device. 
There are two important reasons for this: 

1. The ReGIS Logical Device Addressing scheme will not 
always map one-for-one to the physical device space when 
device transporting S(A) transformations are invoked. 

2. The ReGIS Logical Device addressing scheme does not map 
to all device technologies. 

For example, stroke oriented devices have positioning 
increments, but no real pixels. Also, the underlying 
hardware of some devices may support the pixel-interval 
model as opposed to the pixel-centered model, and do so 
in a way that precludes the pixel-centered model from 
being accurately supported. 


Conforming software must not depend on pixel level access to a 
ReGIS device. 
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Using ReGIS instructions, the user defines the possible range of 
values of X and Y by identifying the numeric values which are 
taken on by X and Y at the four edges. Without loss of 
generality, these parameters may be assumed to be non-negative and 
directly define the following screen area parameters: 

SYT - Value of the Y-position at the top of the screen area 

SYB - Value of the Y-position at the bottom of the screen 

area 

SXL - Value of X at the left edge 

SXR - Value of X at the right edge 

If they are all of integer value, these parameters define the 
total number of usable horizontal and vertical positions. These 
totals are represented as follows: 

SXN = abs(SXR-SXL)+l 

« the number of horizontal screen positions 
SYN - abs(SYT-SYB)+l 

- the number of vertical screen positions 
STN - SXN * SYN 

- the total number of unique screen positions (number of 
pixels) 

The ReGIS Base Logical Device is ignorant of the real physical 
size of a pixel. This accommodates most low resolution graphic 
devices which have no controllable pixel size, as in the case of 
raster CRT, stroke CRT, and storage CRT devices. Other devices 
must define default values of physical pixel sizes from the given 
data while determining the resolution of the original device. 
This may be determined by the parameters described above. The 
concept of physical measure is covered in Extensions to Base ReGIS 
under subheadings 8.6 The Extended Logical Graphics Device, 8.7 
Required Extensions for Raster Devices, and 8.8 Open Extensions to 
ReGIS. 


The parameter SXR is not necessarily greater than SXL and 
similarly, SYT is not necessarily larger than SYB. To define the 
ReGIS instructions in terms of the logical device, is necessary to 
be able to identify the pixels which are above, below, to the left 
and to the right of a given pixel, in terms of the user supplied 
screen coordinate definition. This is accomplished by the X,Y 
screen increments SXINC and SYINC which are defined as follows: 

SXINC - SGN(SXR,SXL) 

SYINC - SGN(SYB,SYT) 


I where SGN( ) is the function returning the sign of the difference 
of the two arguments. By this convention: 


VP(X+SXINC,Y) 
VP(X-SXINC, Y) 
VP(X, Y+SYINC) 
VP(X,Y-SYINC) 


is to the right of VP(X,Y), 
is to the left of VP(X,Y), 
is below VP(X,Y), and 
is above VP(X, Y) . 
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8.3.2 VIEWING POINT ATTRIBUTES 

Each viewing point generally has background intensity and 
foreground intensity attributes as well as a foreground/background 
selector attribute. They are defined in the following paragraphs. 
Each pixel has a background "intensity" value called the BI(X,Y). 
The semantic meaning of the word intensity is implementation 
dependent in the sense of psychophysical and photometric 
measurement units. For purposes of the Base Logical Device, 
intensity is defined simply as some visually discernible property 
of a viewing point; pixels with different intensity values are, by 
definition, distinguishable from each other. The Base ReGIS 
Logical Device is both color-blind and binary in terms of 
intensity attributes, so the possible values BI(X,Y) are either 
"off" or "on". 

The foreground intensity attribute associated with the pixel at 
position X,Y is denoted by FI(X,Y) and in the Base Logical Device 
also has values of either "off" or "on". Because of the binary 
nature of the base device, the FI and BI quantities are redundant, 
but are included here for completeness since they will be needed 
in the definition of the Extended Logical Device. 

This model does not elegantly accomodate devices with other than 
binary display states. In devices that do not have immediately 
differentiable foregrounds and backgrounds, such as multiplane 
raster bit map displays, an arbitrary distinction between 
foreground and background may be required. The accommodation 
chosen for ReGIS is to consider the background specifier as a 
secondary foreground. These issues are discussed further in the 
Raster Extensions. 

Each viewing point has a foreground-background selector function 
denoted by FBS{X,Y,t), which has a binary value that may be a 
function of time. The FBS function for each VP(X,Y) selects 
whether the currently defined foreground or the currently defined 
background attribute is to be seen. Without loss of generality, 
the values of FBS are "F" (for foreground selection, also denoted 
by the binary value "1") and "B" (for background selection, also 
denoted by the binary value "0"). In the base logical device, the 
value of BI(X,Y) is "off" for all (X,Y) and the value of FI(X,Y) 
is "on" for all (X,Y). Then the set of all VP(X,Y) for which 
FBS(X,Y) has value "F" ("1") is visually discernible since it is 
imposed on a background of different, and uniform, intensity. 
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8.3.3 GENERAL DRAWING PROCESS 

Generating an image on the logical device (as distinguished from 
defining the image) involves executing a sequence of instructions 
to modify the FBS values for a selected subset of (X,y) values. 
The sequence of instruction execution is important in ReGIS. The 
general procedure for generating a ReGIS logical image is as 
follows : 

1. Set up the viewing area parameters using the Screen 
control command, S(A[][]). 

2. Erase the viewing area using the S(E) command. 

3. Identify a sequence of (X,Y) positions and change the FBS 
for each of these pixels using the Position and Write 
control commands and the action commands for Vector, 
Curve, and Text. 


An image may be modified by repeating step 3. A new image may be 
drawn by repeating from step 2. A new drawing session may be 
repeated from step 1. Note that step 1 should result in a screen 
erasure, since step 2 follows it. This serves to preclude 
pictures with conflicting definition attributes, such as expected 
display size or orientation, from being shown together. Also, it 
is consistent with the description of the screen setup command, 
which cautions that the state of an existing image is not 
guaranteed across a screen setup operation. 
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8.4 ReGIS GENERAL SYNTAX 

This section discusses the general syntax and some aspects of the 
semantics of ReGIS. This discussion applies not only to the Base 
ReGIS instructions discussed under heading 8.5, but also provides 
the general framework for extending ReGIS in a backward and 
forward compatible way. 

Note 

The syntax of ReGIS is complete as described in 
this section. No extension to ReGIS will require 
that new instruction set data types be added which 
will cause existing implementations to fail. All 
implementations of ReGIS must recognize and parse 
all syntactic elements presented here, regardless 
of the semantic meaning of the syntactic 
representation. In this way, all programs that 
generate ReGIS and all those devices and programs 
that interpret it are compatible. 


8.4.1 ALPHABET 

ReGIS is based on the ASCII character set (and includes assignment 
of some national use positions from that code table). Columns 2 
through 5 of the ASCII Code Table contain all the characters 
needed to express all the constructs of ReGIS. 

The description of ReGIS is in terms of characters, not their 
encoding. It is presumed that all Digital systems support ASCII 
as their standard character encoding. However, there is nothing 
which precludes ReGIS from being transported in foreign codes, 
such as EBCDIC, as long as all the desired descriptive characters 
can be expressed in the chosen code. The user alphabet may differ 
from the required ReGIS alphabet since any characters are 
allowable within quoted strings. Transporting such use is in the 
hands of the users. 

The ReGIS command alphabet consists of the following characters: 
o Letters: A,B,...,Z 
o Digits : 0 , 1 , . . . , 9 

o Punctuation: [ ] , ; . ( ) ' " : @ + - * 


Any and all extensions to ReGIS must conform to these alphabet 
selection criteria. In addition, the following alphabet 
conventions apply. 
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a. Lower case letters a, b, ... z may be used but are 
treated as upper case letters when used outside of quoted 
strings. 

b. The parenthesis characters and ")" are reserved for 

option sequences (outside of quoted strings). 

c. The bracket characters "[" and "]" are reserved for 
position and extent arguments (outside of quoted 
strings ) . 

d. Single and double quote ‘characters ("'" and are 

reserved for delimiting literal string arguments. 

e. The semicolon character is reserved for use as an 

instruction separator. The occurrence of the 
character always terminates an instruction, even if the 
instruction arguments are incomplete or nesting levels 
remain pending. The only exception is that the 
character does not terminate a quoted string 
construction, and may be included within the quoted 
string as a literal character. Synchronization should be 
considered a "recovery" mechanism which, while returning 
the parser to a known state, does not guarantee how much 
of the command currently being parsed has been or will be 
executed. Refer to subheading 8.4.2 General Grammar for 
elaboration of this point. 

A ";" does not terminate macrograph storage operations, 
because such storage definitions are not "instructions," 
but are extra-syntactic operations. 

f. The "at" character "@" is reserved for use by macrograph 
strings and is not used in any other context, outside of 
quoted strings. Within quoted strings, the "@" character 
is treated as a literal character. There is no ability 
to expand macrographs within quoted strings. 

g. The comma character "," serves as an argument separator. 
The comma always terminates the parsing of a 
multicharacter token, except within a quoted string, 
where it is treated as a literal character. The comma is 
needed to separate the X and Y parts of a position 
argument, consecutive numeric arguments to the alphabet 
character Load command, and the option letter "E" from 
any preceding numeric reference in which exponential 
notation might be used. The comma is legal between any 
other paired tokens without affecting the syntactic 
state, unless otherwise noted in this standard. 


TM 


Digital Internal Use Only 



EL-00070-08 31-Mar-1988 Page 8-39 

VSRM - ReGIS GRAPHICS EXTENSION 


h. The blank (space) character " " is ignored outside of 
quoted strings and does NOT serve as an argument 
separator. Spaces are treated as control characters and 
may be included anywhere within the data stream without 
effect, except within quoted strings. 

i. ASCII control characters and similar communications line 
control and device control characters are ignored in 
ReGIS and are allowable anywhere without affecting the 
interpretation process, except within quoted strings, 
where a specified subset of the control characters apply. 


Note 

Certain controls described above are stated as 
being ignored or insignificant in ReGIS under 
certain conditions. There is one exception to 
this statement: The macrograph definition 
terminator may not be divided by any 
character sequence which may be delivered to the 
ReGIS parser, including a blank space or other 
controls. There is no instruction parsing during 
a macrograph storage, therefore the indivisibility 
of the terminator construct is a necessity. 


8.4.2 GENERAL GRAMMAR 

A ReGIS image definition consists of an arbitrary length sequence 
of instructions that may or may not be separated by commas or 
semicolons. Any character other than a defined command keyletter 
is ignored. By this rule, an unattached ReGIS argument (one not 
logically coupled to a command key letter) is ignored without 
effect. Therefore, unattached quoted strings can be used to 
"comment" ReGIS instruction streams or files. The proper way to 
"unattach" an argument is to precede it with a semicolon. The 
semicolon terminates any outstanding keyletter, and the following 
argument is ignored as having no context. 

A ReGIS instruction consists of a keyletter followed by an 
argument list. ReGIS can encode up to 26 different instructions. 

I Only eight keyletters are used in the ReGIS Base allowing 
considerable room for extension. See subhead 8.1.8 ReGIS 
Overview. 
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An instruction argument list consists of an arbitrary number of 
four argument types arranged in an arbitrary syntactic order. 
Semantically, all instructions and instruction arguments are 
assumed to be executed in the "lef t-to-right" order they are 
received. ReGIS syntax does not require that instruction 
arguments be received in any particular order by type. It is the 
semantics of a given command which will determine the sense of 
intermixed argument types. 

Actions take effect when enough characters have been received to 
sufficiently specify an action. A drawing action, for example, 
will usually commence, or continue, upon receipt of a closing 
bracket (]) of a position argument, indicating that the given 
position specification is complete. Unless there is a specific 
need for further information (as would be the case in a curve 
interpolation sequence), drawing can occur regardless of whether 
more point specifiers are being sent as arguments to the current 
command. Similarly, characters received as part of a quoted 
string argument to a Text command can usually be displayed as 
received, without waiting for the string to be terminated. 

Actions involving potentially interacting argument types, may have 
to be buffered before "enough" information can be identified. 
This will often be the case where arguments to option commands are 
involved. Most option commands set state, as opposed to 
generating visible output. Where an action (such as output) does 
occur, it is often modified by state elements that are other 
arguments to the same option. For example, the Raster ReGIS 
command to dump the screen bitmap to a printer is, most simply, 
S(H). The option specifier (H) may, however, include suboption 
specifiers to indicate the offset of the image when printed, such 
as 


■ S(H(P[10,50] ) ) 

or arguments to indicate the exact portion of the display to be 
dumped, such as 


S(H1100, 250] [600,400] ) . 

The complete command might be 

S(H(P[ 10,50] ) [100,250] [600,440] ) 
or the equally valid combination 

S(H[100,250] [600, 440] (P[10,50] ) ) . 

No action should be taken on the occurrence of an option keyletter 
alone until it is seen to have no subarguments that would modify 
such action. 
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In the case of most command options, the entire option must be 
parsed to identify the complete intent of the command. 
Syntactically, arguments of the four types could follow the H 
option indefinitely. The terminating condition must therefore be 
some indication that no further option arguments can apply to the 
option letter in question. This indication may be any one of the 
following: 

a. The matching right parenthesis that closes the left 
parenthesis that initiated the current option level is 
encountered. 

This is the means by which the example above was closed. 
Subsequent arguments apply to the S command, and a new 
keyletter is interpreted at command level. 

b. A new option keyletter is seen at the same level at which 
the current option keyletter is in force. 

Thus the X in 

S(H[100,250] [600, 440] (P( 10,50 ] )X) 

indicates that the (H) option is complete, and any 
buffered state may be applied to its execution. The new 
option indicated by X need not be semantically 
significant in the context in question; it is its 
syntactic presence which serves to delimit. 

The ReGIS implementation resumes parsing at that 
character, so the character is doubly parsed: once as a 
syntactic delimiter, secondly for its semantic meaning. 
Parsing resumes at the option level to the S command. 

c. The synchronizing semicolon is encountered. 

In the command stream 

S(H[ 100, 250] [600,440] (P[ 10,50 ] ; 

the semicolon indicates that the entire parser nesting is 
to be popped. As shown, this represents popping two 
levels of options, since the suboption P was not closed. 
There is no command keyletter in force after this action, 
and any following arguments will be parsed as unattached. 

The visible actions which derive from this synchronizing 
action are not always clear, however. In general, any 
state-saving actions are performed as necessary, but the 
actions conditioned by this state cannot be guaranteed to 
occur. In the example above, the offset definition 
implied by the suboption P[10,50] would likely be saved 
since it is a state definition action, and does not 
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I initiate a drawing or communication action. The 

1 synchronizing action would prevent the actual image dump 

I from occurring. Also, the image extents would not be 

I saved, since they are specified to be volatile settings, 

I and the next S(H...) operation would cause them to be 

I reset to defaults. 

Use of the semicolon should be viewed as a syntactic 
recovery operation, not a semantic terminating operation, 
except as may be noted in specific exceptions in this 
standard. Refer to the terminating condition to the Load 
alphabet command. 

I 

I It is NOT necessary or expected that exiting the ReGIS 

I environment and reentering it via the resynchronizing 

I entry will have the same effect as as encountering a 

I resynchronizing semicolon. The semicolon and 

environmental resynchronizations are two separate 
schemes; they are not meant to be interchangeable. 

I 

I Environmental resynchronization will force 

I resynchronization even from within a quoted string 

I argument or a macrograph definition. Semicolon 

I resynchronization can do neither of these. 


The actions described above show an entity is not complete until 
it is delimited. Such delimiting may be explicit, as with the 
closing quote of a quoted extent, or it may be implicit, being 
terminated by a character of a type not valid for the token in 
question. This is illustrated by the parsing numeric of values. 
In the command 

T( S1D90A2 ) 

the parsing of the values 1, 90, and 2 is terminated upon the 
characters "D", "A", and ")", respectively. 

In some cases, command parsing may have to be "batched" for good 
visual effect. Commands which change an output map, for example, 
may be deferred until all such updates are received, or their 
option string is terminated. This may be required to prevent 
undesirable flashing of the image were updates to be received and 
made piecemeal. Some batched parsings are defined in this 
standard. Implementations that extend such hatchings must clearly 
state this in their product documentation. 

Any decision to implement batching of output may not restrict 
function otherwise defined in this standard. For example, curve 
interpolation in ReGIS places no bounds on the number of 
intermediate points which may be specified as part of the curve 
definition. An implementation which batches the interpretation of 
such curve rendering must still support an unbounded number of 
points . 
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8.4.3 ARGUMENT TYPES 

The following describes the syntax for each of the argument types. 

8. 4. 3.1 Bracketed Coordinate Specifier 

A sequence of characters enclosed in the bracket characters ([]) 
refers to an (X,Y) position argument or increment. The contents 
of a bracketed extent are always numeric and there is no nesting 
of brackets. Any non-numeric character other than a comma 
encountered within a bracketed position argument causes the part 
(x value or y value) being decoded to be terminated and 
interpreted as not present. If more than two parts are 
encountered within one pair of brackets (that is, more than one 
comma is present), only the first two parts are accepted; the 
third and any subsequent parts are ignored. See subheading 

8. 4. 3. 3 Numerics. 

8. 4. 3. 2 Quoted Strings 

A sequence of characters beginning with the single quote character 
(') or the double quote character (") and ending with a quote 
character of the same type is a text string and treated as a 
single argument. The contents of a quoted string are entirely 
arbitrary. Once the opening delimiter is seen, all following 
characters are interpreted literally until the string is 
terminated by the matching quote character. 

ReGIS allows 8-bit encoding of character arguments within quoted 
strings. Legal character codes are 2/0 through 7/15, and 10/0 
through 15/15 (two 96 character sets, 192 characters total). The 
accessibility of codes 7/15 and 15/15 is not guaranteed because of 
their interpretation as control characters in some environments. 
Provision for them must be made in alphabet storage, however. 

The quote characters themselves are not part of the text string; a 
string which is introduced by a quote of one type is not 
terminated by a quote of the opposite type. Therefore, a quote of 
one type can be included in a string by using the quote character 
of the other type as the string delimiter. 
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Should it be required to include a quote character of a given type 
within a string delimited by quotes of the same type, the target 
quote character must be doubled, that is, repeated in place 
without any intervening characters. For example. 


If ah 

encodes 

the 

string 

A 

f H f 

encodes 

the 

string 

tt 

It f It 

encodes 

the 

string 

f 

'a' 'C' 

encodes 

the 

string 

a'C 

f f f f 

encodes 

the 

string 

9 


encodes 

the 

string 

A'"B 

tt tt 

encodes 

the 

empty i 

String 


ReGIS instructions may have multiple string arguments. Consider, 
however, that if 'ABC' and 'DEF' are two consecutive string 

arguments, then the resulting structure is 'ABC' 'DEF', which will 

be treated by ReGIS as the single string ABC'DEF. This undesired 
result is avoided by separating possible consecutive string 
arguments with the comma character. 

A potential ambiguity arises in the case of doubled quotes 
separated by control characters. Outside of quoted strings, all 
control characters and SPACE are treated as "no character" by 
ReGIS. Within quoted strings used as arguments to the Text 
command, the controls BACKSPACE, CARRIAGE RETURN, LINE FEED, 
HORIZONTAL TAB, and SPACE have meaning. 

Should paired quotes within a set of paired quotes be separated by 
BS, CR, LF, HT, or SP, then they are NOT considered doubled, and 
I two quoted arguments are recognized as if they had been separated 
I by a comma. When separated by other controls, these controls are 

I interpreted as "no character" and the quotes are considered 

I doubled, forcing the inclusion of one of the quotes in the string 
I argument. Hence, if in the command stream 

T" text" <> "more text" 

the token <> were replaced by one of SP, BS, HT, LF, or CR, then 
an equivalent command stream would be 

T" textmoretext" 

because of the resulting doubled quote. Were <> to be replaced by 
any other control, an equivalent command stream would be 

T"text" "moretext" 

resulting in the effective text argument 

texfmoretext . 

Were <> to be replaced by a macrograph definition (which is 
specified not to disturb the state of the parser, but which is not 
I allowed within quoted strings), the quotes are NOT doubled. The 
I result is, again, as if the two quoted extents were separated by a 

I comma. The macrograph definition would succeed, but would have 
the side effect of acting like a supported control character. 
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8. 4. 3. 3 Numerics 

Digit characters represent either numbers or sequences of 
arguments where each argument is a single digit character. The 
I distinction between such uses is semantic, not syntactic and is 
I distinguished by context. The ReGIS grammar allows numeric 
I information to be skipped when the context is not known to an 
I implementation. Digit strings may have semantic meaning as 
numbers, and integer, fixed point, floating point, and scientific 
notation formats are accepted. 

The allowable alphabet for numeric representation is composed as 
follows : 

o Digits zero through nine 
o Plus and minus signs 
o Decimal point 

o The letter "E" or "e", for scientific notation 

The composition of these elements into numbers is by common rules. 

I A simple BNF-like expression of the allowed format for these 
numbers is 

I <number> l+|-] <unsgnreal> [<exponent>] 

I <unsgnreal> ; := <digits>* [ . ] <digits>+ 

I I <digits>+ [.] <digits>* 

<exponent> ; E[ + | - ] <digits>+ 

I In this expression format, "|" means OR, means production, 

"<token>*" means zero or more instances of <token>, "<token>+" 
means one or more instances of <token>, and [] enclose optional 
constructs. In words, this means that a number consists of: 

A string of one or more digits, with an optional decimal 
point placed either before, after, or within the string, 
this string being 

a. optionally preceded by a single sign character, AND 

b. optionally followed by an exponent comprising 

1. the letter "e" (upper or lower case), 

2. followed by a string of one or more digits, 
optionally signed. 


Any character other than those noted as legal numerics terminates 
the scan, and the accumulated numeric extent is taken as complete. 
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The character causing the termination is rescanned as part of the 
next token following the number. Consecutive numeric arguments 
must be separated by commas to ensure proper decoding. 

I The results of encountering an apparent numeric which violates the 
I above grammar (such as having more than one sign character, more 
I than one decimal point, a sign character or decimal point with no 
I digits, or more than one exponentiation operator (E) within a 
I single numeric token) are not specified in this standard, and such 
occurrences must be considered an error with device-dependent 
recovery. 

The inclusion of the letter "E" in the numeric alphabet may create 
ambiguity in certain instances of consecutive arguments. The 
construct X(YlE2) could be a legal specification of the 
(hypothetical) X command with quantified options Y and E, having 
values 1 and 2, respectively. Because of the use of the letter 
"E", the above construct could also be interpreted as the X 
command with a quantified option of Y with a value of le2, or 100. 
A ReGIS interpreter must always interpret the letter "E" 
numerically where such use is conceivable in context. 

I Hence, as shown, the interpretation of (Y1E2) would be as (YlOO). 

I Note that (Y1E2E3) would have to be interpreted as (Y100,E3), 

I since the numeric grammar precludes the interpretation of a second 
I exponentiation operator in a single numeric. 

ReGIS generators must always precede the "E" character with the 
option-separating comma when there is any chance of a semantic 
error. 

Where digit strings are used as pixel vectors described under 
subheading 8. 4. 5. 3 Pixel Vectors, the sign characters and the 
decimal point are ignored without effect, and the interpretation 
of the digits takes place normally. Any other character 
terminates the digit string scan, and the scan state changes to 
that indicated by the non-digit character. This is also true of 
the letter "E", which, although normally valid in numerics as an 
exponentiation operator, must be interpreted as a keyletter at the 
current option level. 

8. 4. 3. 3.1 Dynamic Range and Precision 

Implementations are not required to USE any fractional part of a 
completely decoded numeric. However, all implementations must 
RECOGNIZE when fractions occur, and not truncate to integers until 
the number is COMPLETELY parsed and decoded. In particular, 
exponential format numbers may have a fractional part and yet 
resolve to an integer. The format 1.02e2 must resolve to 102, not 
100 . 
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The need for proper decoding of values expressed using negative 
exponents is less clear. For example, the form lOOOOOe-3 resolves 
to 100, but the 100,000 part would overflow the integer precision 
of many implementations. Thus, the goal of interpreting 
exponential formats is targeted toward the use of exponentials 
that resolve into the supported integer range of most devices, and 
the use of large negative exponents in such forms is deprecated. 

All implementations must support signed integer arithmetic in a 
range no less than -32767 to +32767, that is, sixteen bits of I's 
or 2's complement expression. 

8. 4. 3. 3. 2 Numeric Format Violation 

The numeric arguments for the Load character cell command (not a 
part of Base ReGIS) operate somewhat in violation of the above 
rules. The Load command uses a potentially variable radix for 
specifying character masks, and typically uses hexadecimal. In 
this case, the characters a through f (and A through F) are not 
keyletters, but numerics. Hence, implementations should recognize 
the L command as a special case, and, if it is not supported, 
enter a special skip state to wait for the next synchronizing 
semicolon, which is required to terminate the Load command. 

8. 4. 3. 4 Options 

Sequences of characters enclosed within the parenthesis characters 
"(" and represent instruction options. The syntax of each 
option is the same as the syntax of a ReGIS instruction, including 
the four argument types. The option syntax is thus fully 
recursive, allowing theoretically infinite extensibility of ReGIS 
semantics. The components of all the arguments types are the same 
within options as they are at the command level. 

For readability, options, also called sub-instructions, may be 
separated by comma characters but not by the semicolon character. 
The semicolon character terminates the instruction to the highest 
level . 

ReGIS interpreters must be prepared to accept recursion of options 
to at least six levels. A conforming ReGIS generator must not 
exceed this level of recursion. Recovery from an attempt to 
exceed allowable recursion depth is to the highest command level, 
just as if a semicolon character had been encountered. 

The hypothetical command 

X(A(B(C(D(E(F) ) ) ) ) ) 

represents the deepest legal nesting of option levels. Any 
argument type applied to suboption letter "F" other than another 
option level would be properly interpreted. Suboption "E" could 
legally accept other suboptions, as well. 
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Unless otherwise specified in the body of the option description, 
option settings are modal, that is, they represent a change of 
state which is maintained across commands until explicitly changed 
by resetting the option or by the side effect of another action. 
Coloquially, such options are referred to as "sticky". 

Some options, particularly in the Curve instruction and all of the 
temporary Write options, are "volatile." They remain in effect 
only for the duration of the command in process. These options 
revert to their default state (or to their previous modal state, 
if applicable) when a new command keyletter or a synchronization 
operation is processed. 

All commands whose actions reference state set by the Write 
options command, W, may include W as an option, and may set any 
W-settable state for the duration of that command. The W-state 
previously in force (set by a W at the top command level) is saved 
when the option W is encountered, and is restored when the current 
command is terminated by synchronization or the occurrence of a 
command keyletter. Such option level state is always volatile. 
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8.4.4 MACROGRAPH STRINGS 

The concept of the macrograph is derived from the assembly 
language programming construct of macro instructions (macros). 
The macrograph facility is "extra-syntactic." 

Macrograph strings provide the ability for commonly used character 
sequences to be stored in the graphics device and then referred 
to, repeatedly if necessary, in the sequence of instruction 
execution. This facility reduces the number of characters that 
must be transmitted over the communications interface. For 
example, if the image being drawn is a sheet of music, each of the 
different types of notes could be defined in a macrograph; they 
could then be referred to by name rather than by content. The 
result can be a significant reduction of communications overhead 
without substantially reducing image definition readability. In 
some cases, readability may even be improved by such compaction. 

Macrograph strings are "extra-syntactic" in that they conform to a 
grammar built on top of the ReGIS general grammar. Therefore, 
macrograph definitions may take place anywhere in a ReGIS command 
stream without affecting the state of the ReGIS parser. A 
macrograph definition may even occur within the extent of a 
numeric argument without adversely affecting the interpretation of 
that numeric value. 

Because of the co-precedence of quoted string extents and 
macrograph transactions, however, neither macrograph definition 
nor expansion may take place within a quoted string. Similarly, a 
quoted string within a macrograph definition is not treated as a 
quoted string until the macrograph is invoked. 

A macrograph invocation affects the state of the parser only 
insofar as it provides a different character input path. In the 
process of parsing ReGIS instructions, the detection of a 
macrograph string reference causes the characters previously 
defined for that macrograph to be substituted for the string 
reference characters. In the general case, a macrograph string 
may be just an argument of an instruction (such as a position 
argument) or may even be a piece of an argument (such as an 
argument to a sub-instruction or one element or part of an element 
in a coordinate pair). 

All operations relating to macrographs are initiated by the "at" 
character "@". Altogether 26 macrograph strings can be defined, 
each identified by a single letter of the alphabet. Lower-case 
letters are converted to upper-case for the purpose of macrograph 
string identification. 
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The entire set of macrograph strings is cleared by the character 
sequence ("at" followed by period). The operation of 
clearing a macrograph causes the string to consist of no 
characters (the empty string). The default content of all 
macrographs is the empty string. 

An attempt to execute the global clear (0.) from within a 
macrograph is an error. Determination of and recovery from this 
error is not specified in this standard. 

A macrograph string is defined by the sequence 

0 : <letter><string>0 ; 

where <letter> refers to any alphabetic character, and <string> is 
any sequence of characters not containing "0;" or "0:". The 
sequence "0:" (colon) is called the macrograph definition 
initiator. The sequence "0;" (semicolon) is called the macrograph 
definition terminator. 

Neither a macrograph clear nor a macrograph definition affects the 
state of the ReGIS interpreter. A macrograph definition may occur 
at any point in the ReGIS instruction stream, between keyletters 
and arguments, between arguments, or within an argument, without 
affecting the interpretation of of the ReGIS stream. Macrograph 
invocation, on the other hand, causes previously stored pieces of 
the ReGIS stream to be inserted into the interpreted stream, in a 
manner indistinguishable from non-macrograph ReGIS. 
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A macrograph string is invoked by the sequence 

@<lette r> 

where <letter> is one of the names given a previously defined 
macrograph. Such a sequence may appear anywhere in a sequence of 
ReGIS instructions, except within a quoted string. Macrographs 
cannot be expanded from within quoted strings. 

A macrograph string cannot contain the definition of another 
macrograph string. Determination of and recovery from this error 
is not specified in this standard. 

A macrograph string may include invocations of other macrograph 
strings, but a macrograph string must not invoke itself either 
directly or indirectly. There are no conditional execution- 
controls in ReGIS, therefore there is no termination mechanism for 
recursive invocation. Determination of and recovery from this 
error is not specified in this standard. 

Once defined, a macrograph may not be extended. The first action 
taken upon the occurrence of a macrograph definition initiator 
must be to clear the contents of the specified macrograph. 

A single macrograph string may be of any length from no characters 
up to the defined storage limit of the ReGIS device, thereby 
excluding all other macrographs from use. Conforming 

implementations must provide for no less than 4000 characters of 
macrograph storage. .User attempts to exceed the macrograph 
storage capacity will "fail soft" with the following results: 

a. No other macrographs already stored will be affected. 

b. Any part of the macrograph string being stored which is 
already stored will remain stored. 

c. The remainder of the attempted definition will be 
discarded, but the definition will terminate "normally" 
upon the next occurrence of the macrograph definition 
terminator, and there will be no effect on the command 
state of the ReGIS interpreter. 
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8.4.5 POSITION ARGUMENTS 

ReGIS maintains a current drawing position. This means that each 
graphics primitive starts at the "position" left by the previous 
operation. Vector commands, for example, have an implicit start 
point, and only a single argument (the other end point) is 
required to specify a line. The effect of any command upon the 
current position is described with the definition of that command. 

ReGIS implementations may, at their option, provide a visible 
cursor which tracks the current drawing position. This standard 
neither specifies nor precludes such a feature. 

ReGIS provides two syntactic structures for the definition of 
drawing positions; (X,Y) coordinates and pixel vectors. The 
(X,Y) coordinate structure is the traditional system of defining 
positions. It specifies two numbers separated by a comma, with a 
semantic extension which allows absolute and relative coordinates 
to be distinguishable in context, thus eliminating the need to 
have separate relative and absolute instructions or options. 
Pixel vectors correspond to the "chain encoding" technique used to 
drive many incremental plotting devices. 

8. 4. 5.1 Position Argument 

A position argument is delimited by a pair of left/right square 
brackets, both of which must be present. A position argument 
consists of an x-position part and a y-position part, either or 
both of which may be missing. The x part precedes the y part. 
Each component is made up of numbers, following the rules for 
numbers as standalone arguments. The y part, if present, is 
separated from the x part by a comma. See subheading 8. 4. 3. 4 
Numerics . 

Each coordinate part consists of a number possibly preceded by a 
plus or minus sign ("+" or "-" ) . If a coordinate part is not 
preceded by a sign character, that argument represents an absolute 
I coordinate; the value of the coordinate part is the new number, 

I irrespective of the value of the current drawing position. If a 
coordinate part is preceded by a sign character, then that part is 
I evaluated relative to the current drawing position value. A 
position argument may have one coordinate part as a relative 
specifier and the other coordinate part as an absolute specifier. 

If a coordinate part is missing, that part is interpreted to mean 
+0, which is a relative specifier indicating a displacement of 0. 
Note that +0 is a different specifier from 0, which is an absolute 
specifier. 

For each example below, assume the initial values of X and Y are 
100 and 50 respectively. 
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Position Spec Effective Addr 


[0,0] 

0 

0 

[30,23] 

30 

23 

[200] 

200 

50 

[,42] 

100 

42 

[+10,-25] 

110 

25 

[0,+10] 

0 

60 

[15,20] 

15 

20 

[10,20] [+5] 

15 

20 

.2 Use of 

Bracketed 

Extents 


(only X changed) 

(only Y changed) 

(relative change) 

( combination 
relative and 
absolute change) 

(multiple specifiers have 
cumulative action) 

for Non-Positional Information 


Some ReGIS commands are defined to use the square brackets to 
enclose non-positional information, as for specification of 
positional information not coupled to the current drawing position 
or to the imposed coordinate space in effect. Some uses are for 
expression of rectangular extent, others are for situations where 
"position-like" information is required. 


The following uses of bracketed extent are non-positional. 
In Base ReGIS; 


1. S(A[][]) - The contents of the bracketed subarguments 
define the imposed address space. They have no 
dependence on current position, and signed values are 
interpreted as absolutes. Negative values for imposed 
coordinate space are not allowed. Missing values (fewer 
than two bracketed extents or unspecified values within 
the brackets) result in illegal specification. 

2. T[ ] - Character escapement for the text command is 
measured in the imposed coordinate space, but these 
values are always interpreted as relative to the current 
position, even if the provided values are unsigned. 
Omitted values are interpreted as spacing of +0. 

In Raster extentions to ReGIS: 


3. T(M{]) - The storage cell multiplier is not positional, 
but the two elements are an ordered pair of multipliers. 

4. T(U(]) and T(S[]) - The Unit and Display sizes of 
character cells are measured in the imposed coordinate 
space, but do not relate to current position. Missing 
values default to values associated with standard size 
characters. 
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5. L[] - The storage size of a character is measured in 
technology-dependent units, usually bits of storage. 
There is no association with current position; missing 
values are interpreted as 0 . 

In Open extentions to ReGIS: 

6. S(H(P[])) - The hard-copy offset is not coupled to 
current position. Its relationship to the imposed 
coordinate space is implementation- and retransmission 
protocol- dependent. Missing values are interpreted as 
0 . The bracketed arg\aments to the H option itself ARE 
positional, do relate to the imposed coordinate space, 
and may be expressed in terms of the current position. 


8. 4. 5. 3 Pixel Vectors 

A pixel vector is represented by a single digit character in the 
range of 0 to 7 . Each of these numbers refers to one of the eight 
pixel neighbors relative to the current position. As illustrated 
in Figure 8-2, pixel vector number 0 refers to the right, pixel 
vector number 1 refers to the pixel up and to the right, and so 
forth around a circle in a counter-clockwise direction. These 
directions are constant, and are not affected by the display 
surface orientation set by the Screen address setup command 
S(A[] []) . That is, pixel vector 0 is always to the right, even if 
the +X direction has been defined to be to the left . 



Figure 8-2: Pixel Vector Directions 

The character sequence 2057 refers to a sequence of four pixel 
vectors and not to the number two thousand fifty seven. 

Pixel vectors allow only relative positioning and not absolute 
positioning. 
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The default size of a pixel vector is the unit integer size 
defined by the screen coordinate setup operation, S(A[][]). This 
length is modifiable by a multiplicative factor specified in the 
writing attributes instruction. Scaling of horizontal and 
vertical components of the pixel vector is isotropic, that is, an 
increment of distance in X is taken to be the same distance as 
that increment in Y. 

Depending on the granularity of the unit pixel size defined by the 
screen coordinate setup operation, the exact position after 
executing a sequence of pixel vectors is subject to roundoff error 
and thus pixel vector positioning sequences should be broken 
occasionally by absolute positioning, or by position reports. 

For the examples which follow, assume that the ReGIS coordinate 
space has been set with an upper left origin, and that initial 
values of X and Y are 100 and 50, respectively. 

Multiplier Pixel string New (X,Y) Value 


1 

0 

101 

50 

1 

1 

101 

49 

1 

0002 

103 

49 

(any) 

01234567 

100 

50 

5 

667 

105 

65 

23 

5 

77 

73 

1 

0000000000 

110 

50 


8. 4. 5. 4 Position Stack 

ReGIS provides for the current drawing position to be saved for 
use by commands which may follow in the command stream. The 
mechanism for such saving is a stack. A current drawing position 
can be saved by a "begin block" operation and later, after 
possibly several intervening position changes, the position can be 
restored to its old position by an "end block" operation. 

The begin and end points are identified by option characters "B" 
and "E" in the option arguments of the drawing and positioning 
instructions which use the block structure. 

There is only one stack on which positions are saved, and only the 
Vector and Position instructions have access to this stack. The 
Curve instruction does NOT use this stack, since the state 
required for curve maintenance is more complex than that of 
vectors and positions. Thus, an "end" reference in a vector 
instruction can cause a position saved by a "begin" operation in a 
position instruction to be returned. 

ReGIS devices must provide a stack at least eight positions deep. 
While more depth may be provided by devices, conforming software 
should never assume more than eight entries. 
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Should stack capacity be exceeded during a save, the current 
element (the value for which the save failed) is not saved, but 
discarded. 

Stack underflow will cause NO ELEMENT to be returned. NO ELEMENT 
is distinguished from an empty bracketed pair ([]) in that the 
former implies no argument present (as would be fetched from an 
empty macrograph), and the latter implies the use of current 
position for a position argument. in the case of a null argument 
to a Vector command, no drawing is done; in the case of an empty 
argument ([]), a single dot is drawn to indicate a line drawn from 
the current position to the current position. 

8.4.6 EXTENSIBILITY REQUIREMENTS 

The following notes give general requirements for extending ReGIS 
to take advantage of device specific characteristics: 

a. The ReGIS syntax of keyletter and four defined argument 

types is fixed and will not be extended. New features 
must be added to ReGIS by assigning meaning to previously 
unassigned keyletters, or by assigning semantic meaning 
to previously unspecified keyletter/argument 

combinations, such as by adding options to existing 
instructions. 

b. A new instruction type shall be added to ReGIS only if: 

1. The new operation cannot be conveniently or 
efficiently performed by a sequence of existing ReGIS 
instructions, and 

2. The designer can ensure a minimal loss of information 

content when the new instruction is ignored by a 
ReGIS device which does not implement the 

instruction. 


By this reasoning, new instruction types must minimize 
side effects of state to the greatest degree possible. 
For example, no command not already defined shall affect 
the drawing position, as this element of state is 
critical to the basic ^drawing process, and commands 
unknown to older implementations could not possibly be 
accommodated if such changes were to occur. 

c. Extensions must be unique. The same command semantics 
must not be used to specify different effects on 
different types of devices, except where the differing 
effects are closely related and controlled by a mode 
setting. (Refer to the two modes of on-screen data 
movement and the S(D) switch as an example.) 
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d. ReGIS shall not be extended beyond its intended range of 

applicability as outlined under heading 8.2 ReGIS 

Philosophy. 

e. Extensions will be registered via Engineering Change 
Orders (ECOs) to this document, either as additions to 
existing chapters, new chapters, or in appendices, as 
appropriate to the meaning and classification of the 
extension. 


Warning to Device Implementors 

Product dependent extensions to ReGIS not 
registered in this standard may jeopardize the 
certification of the product as ReGIS-conforming. 
Such extensions include assignment of unused 
keyletters or arguments, or interpretation of 
assigned elements in a non-standard way. 
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8.5 BASE ReGIS INSTRUCTIONS 

I This section details the semantics of the eight Base ReGIS 
instructions . 

8.5.1 SCREEN INSTRUCTION 

The screen instruction, keyletter "S", controls screen coordinate 
parameters and attributes which affect the entire viewing area. 
In the ReGIS Base, this instruction includes clearing the screen 
area, setting the coordinate system to be used, and making 
adjustments to device specific parameters. 

8. 5. 1.1 Position Arguments 

There is no significance to bracketed position arguments to the S 
command in Base ReGIS. 

8. 5. 1.2 Numeric Arguments 

There is no significance to numeric arguments to the S command in 
Base ReGIS. 

8. 5. 1.3 Quoted String Arguments 

There is no significance to quoted string arguments to the S 
command in Base ReGIS. 

8. 5. 1.4 Options 

8. 5. 1.4.1 S(A[][]) - Screen Address definition 

The screen coordinate definition option allows the user to define 
the coordinate range to be used in position arguments. In the 
absence of this command, the default device coordinate range will 
be in effect. The implementation default is not standardized, and 
may or may not, at the implementor's option, reflect the actual 
physical resolution of the device. Throughout this document, the 
coordinate space defined by the last effective S(A[]t]) command is 
referred to as the "imposed" coordinate space. 

Warning to Applications 

Applications failing to use the screen address 
command for device setup run a great risk of 
sacrificing portability. There can be no 
guarantee that future devices will maintain the 
same address range as existing devices; 
applications that do not include provision for 
imposing a coordinate space may prove very limited 
in terms of inter-device portability. 
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The screen definition option has two position arguments. These 
specify the user-defined coordinates of the upper left and the 
lower right corner of the viewing area rectangle, respectively. 

If fewer than two address specifiers are given in the S(A[]t]) 
command, or if the specified address space would require absolute 
negative coordinate values to be properly referenced, the command 
is ignored and the address space previously in effect shall be 
maintained. 

If more than two address specifiers are given in the S(A[][]) 
command, just the first two are used, the remainder are ignored. 

I Missing elements inside the brackets cause the command to be 

I ignored. As described under heading 8.3 Base Logical Graphic 
Device, this will be sufficient information for the device to set 
up appropriate scaling functions for most other address-related 
device features. In particular, the default length of the pixel 
vector is taken to be equal to 1.0 unit as defined by the values 
of the addresses of the corners specified in the S(A[][]). Other 
side effects of this operation are listed at the end of this 
discussion. 

The screen coordinate option is not meant to be used as a viewing 
or image transformation. That is, it shall not be used to define 
a coordinate system which "makes sense" for the user's specific 
problem. Such transformations are more appropriately accomplished 
with higher level software. The option is to provide a mechanism 
for transporting image definitions from one device to another, 
while ensuring that the maximum capability of a device is usable 
in the simplest cases. 

The state of any image existing in the display need not be 
guaranteed when an S(A[][]) is executed. In particular, devices 
may perform a new frame or screen clear action if that is required 
to support a new imposed coordinate range. Applications should 
still send the S(E) command before beginning to draw. Not doing 
so could produce undesirable side effects. 

8. 5. 1.4. 1.1 Mandatory Arithmetic Range 

The screen address setup applies to the orientation and magnitude 
of the Cartesian (bracketed) coordinate specifications of 
addressing the display surface. Left and right, up and down, 
clockwise and counterclockwise describe the user's view of the 
display in its normal orientation. As described earlier, pixel 
vector orientation is always 0 to the right, 2 up, 4 left, and 6 
down, with the odd numbers diagonally in between. The default 
direction for text is left to right along the baseline; down is 
the direction below the baseline. Thus, an attempt to reflect an 
image in its totality merely by inverting the X address space (as 
to implement rear projection video, for example) will likely fail. 
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Though the screen addressing limits specified in the S(A[][]) 
command will normally cover the desired range of device addresses, 
use of values outside this range may be desirable. ReGIS devices 
must properly interpret addresses beyond the "edges" so defined to 
at least twice the defined extent of the display. Such legal use 
is positioning the center of an arc outside the display, even 
though the entire arc drawn is within the viewing area. 

Since ReGIS implementations may provide for as little as sixteen 
bits of integer arithmetic precision, the effect of the two bit 
"guard band" on off-screen addressing is that the largest 
guaranteed value for on-screen addressing is 16383, or (2**14) -1. 





Figure 8-3: Off -display Screen Addressing Example 
The command 


S (A[0, 0] [1000,750] ) 

defines a display extent 1000 by 750 units, with an upper-left 
corner origin. The legal addressing range must then be at least 
-1000 to +2000 in X, and -750 to +1500 in Y. This allows relative 
specifiers to access negative addresses, and off screen accesses 
to be recovered without special precautions. Figure 8-3 shows 
this positioning of address space. 

Left and right margins shall not "wrap" immediately to one 
another, nor shall top and bottom. ReGIS generators should never 
expect to take advantage of such abnormal effects for defined 
purposes. 
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8. 5. 1.4. 1.2 Accommodation of Shape 

The region defined by the S(A[][]) is the "region of interest" of 
graphics output. It is device dependent as to whether all 

graphics output is limited to this area. For example, the area 

specified by S(A[](]) might not use the entire visible extent of 
the device, either because the device cannot adequately scale the 
range specified to the entire width and height of the display, or 
because the shape of the area specified does not exactly match the 
shape of the display. In such cases, it is the device's option as 
to whether graphics actions taken outside the range specified by 
S(A) are visible in this unmapped area. 

Furthermore, it is left to the device to position the area 

represented by the S(A[]t]) as it can within the visible display, 

with three constraints: 

1. The shape (aspect ratio) implied by S(A(][]) must be 
maintained. 

The command S(At0,0] [1000,750] ) implies an area one and a 
third times as wide as it is tall. The area on the 
display to which the source address space is mapped must 
maintain this shape; if the target width is to be 768 
units wide, for example, then the height must be 576 
units tall. 

2. All the area implied by the S(At][]) must be visible in 
the target mapping. 

In the case immediately above, if the available height of 
the display were only 480 units, so that the required 576 
units would not fit, then the width used could not exceed 
640 units, maintaining both shape and visible extent. 

3. An implementation may elect to use an integral scaling to 
fit the requested coordinate space into the device space, 
but any such mapping must use at least half the visible 
extent of at least one of the horizontal and vertical 
extents of the available hardware. 

Consider the cases as above, in which the requested space 
is 1000 by 750 units. If the target device has native 
addressing of 768 by 480, then incoming address values 
can be divided by two, and only 500 by 375 device 
addressing will be used. Note that if the requested 
address space were 1000 by 300, then dividing by two 
would use only 500 by 150 device units. While 150 is 
less than 1/3 the available vertical range, more than 
half of the horizontal range is used, meeting this 
requirement while maintaining the requested aspect ratio. 
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The placement of any subset range within the device space is left 
to the device implementor. Conforming software shall not depend 
upon a given alignment of requested space within device space, nor 
shall it depend upon the exact scale factor used to map the 
requested space to the device space. Figure 8-4 shows how a 1000 
by 750 unit space could map into video- and page printer-like 
display spaces . 


850 



S(A[0,0] [1000,750]) 

mapped into_800x480 S {A[0, 0] [1000, 750] ) 

landscape display. _ mapped into 850x1100 

portrait display. 


Figure 8-4: Accommodation of Aspect Ratios 
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Within the constraints described above, a device is allowed to 
re-orient its display surface with respect to horizontal and 
vertical to better match an imposed address space, as long as all 
reorientation takes place as if the device were exactly a device 
of the assumed aspec.t ratio. In other words, "turning" the 
display surface horizontally or vertically to fit a particular 
graphic may be desirable. 

The above action is not likely in an interactive video device, but 
may be useful in a hard-copy device, where the output is viewed 
out of the context of its generating hardware. For example, an 8 
1/2 by 11 inch plotter best mimics the 4 to 3 aspect ratio of 
video when the long axis is the horizontal (landscape mode). 
However, if used to execute graphics for publication, the vertical 
may be the more natural long axis (portrait mode). The magnitude 
of the horizontal to vertical aspect ratio implied by the S(A[](]) 
relative to unity may be used to infer the utility of 
reorientation. 

Each physical device has its own pixel and picture aspect ratios. 
The pixel aspect ratio is the ratio of the width to the height of 
the physical picture elements of the display. ReGIS expects the 
display medium to be isotropic (equal measure in the X and Y 
dimensions, that is, a perceived pixel aspect ratio of unity). 
The implementation must shield variations in pixel aspect ratio 
from the application; ReGIS provides no assistance. 
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8. 5. 1.4. 1.3 Numeric Accuracy 

Note that ReGIS allows numeric parameters to be given in integer, 
floating point, and scientific notation. The following two rules 
are guidelines to be used in determining the degree of fidelity 
necessary for different devices in implementing the numeric 
formats : 

1. Low resolution devices are assumed to use integer numeric 

quantities only. However, low resolution devices must 
extract the integer portions of floating point and 
scientific notation number constants. Refer to 

subheading 8.4.3 Argument Types and subheading 8. 4. 3. 3 
Numerics for rules on numeric interpretation. 

Allowing the truncation of numbers with fractional parts 
to the next lower integer numbers on low resolution 
devices precludes the use of the unit screen concept of 
fractional addressing. 

2. High resolution devices are expected to use the entire 
resolution provided by floating point numbers. The 
fractional portion of numbers should not be ignored. 
These devices are expected to use a nearly exact 
coordinate transformation algorithm which loses little, 
if any, of the usable viewing area, subject to mismatches 
of imposed and available aspect ratios. 


8. 5. 1.4. 1.4 States Set to Default as a Side Effect of S(A[][]) 

The following states are set to the following default values 
whenever a valid S(A) is executed: A "valid" S(A) is one with two 
extent arguments, both of which are expressed in terms of 
non-negative imposed position values. The. equivalent ReGIS 
command which would institute this setting is shown after the 
defined action. 

a. Current position is set to [0,0] in the imposed 

coordinate space. 

Equivalent explicit command: P[0,0] 

b. The pixel vector multiplier is set to 1. 

Equivalent explicit command: W(Ml) 

c. The line pattern is set to solid, and the line pattern 
element multiplier is set to 2. 

Equivalent explicit command: W(P1), W(P(M2)) 
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d. Text character escapement is set to rightward movement 
the width of one standard size 1 character cell, with 
device-optional extra intercharacter spacing, and no 
vertical movement. Vertical movement executed upon Line 
Feed is one standard size 1 character height downward, 
with device-optional extra downward interline spacing. 
Pixel vector character motion is always one-half a 
character extent. 

Equivalent explicit command: T[<-fw>,0] assuming X 

increases rightward (else use <-w>); w is not less than 
the width of a standard size 1 character 

Equivalent explicit command: T[0,<+h>] assuming Y 

increases downward (else use <-h>); h is not less than 
the height of a standard size 1 character 

e. Character set selection is returned to the default state 
for the device. This is normally ASCII in GL and the 
appropriate supplemental set in GR. 

Equivalent explicit command: T(A( L"0B" ,R"lA" ) ) 


The macrograph store is not affected by executing an S(A). 

8. 5. 1.4. 2 S(E) - Screen Erase 

The screen erase option initializes the display surface in 
preparation for a new image. The precise meaning of "erase" is 
device dependent, but generally has the connotation of creating a 
homogeneous visual image. In some systems, this operation is 
called "new frame." 

S(E) clears the position stack (loaded by P(B/S) or V(B/S)). 
Shading state, a ReGIS extension set by W(S), is disabled on S(E). 

8. 5. 1.4. 3 S( F<integer> ) - Feed medium 

In hard-copy devices with movable media, this command causes a 
"sheet feed" or equivalent action to occur. The numeric argument 
to the F option indicates how many frames of the medium are to be 
advanced. The default value, 0, indicates that the medium is to 
be moved one frame only if some drawing action has occurred since 
the last S(F) or S(E) command. Devices which can recover media 
already advanced are allowed to implement negative values for this 
option. Negative values are interpreted as 0 in devices which 
cannot support negative values. 
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S(F) can be used as an "image complete" indicator for ReGIS 
interpreters, including both hard-copy devices and image 
conversion utilities. Systems which do not run interactively 
often need such an indicator to identify the end of the ReGIS 
stream, so that they may take further image processing action. 
S(F) does NOT imply image retransmission, as does S(H), and should 
be used at the end of any stored ReGIS file to indicate "image 
complete," even on files sent to interactive devices. ReGIS-based 
images intended for file storage should be terminated with S(F) to 
facilitate their handling in such environments. 
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8.5.2 POSITION INSTRUCTION 

ReGIS assumes and uses the "current position" or "current drawing 
position" convention for determining where a drawing instruction 
starts its operation in the viewing area. A ReGIS device is 
required to maintain the value of an X and Y set of numbers, and 
these saved values are assumed always to be the starting point for 
a drawing operation. These values are updated to new values after 
each drawing operation. An example of the current value concept 
is the position of a drawing pen on a flat-bed plotter device. 

The Position instruction, keyletter "P", changes the value of the 
current drawing position without drawing any visible image. One 
physical analog is the movement of the plotter pen with the pen 
up. ReGIS allows the drawing position to be moved on both 
absolute and relative bases. 

8. 5. 2.1 Position Arguments 

Position arguments to the position command cause the current 
drawing position to take on the value specified by the argument. 

Multiple position arguments may be associated with a single 
Position command, or pixel vectors may be intermixed with position 
I arguments. Each argument is executed in turn, providing 
I cumulative results. 

8. 5. 2. 2 Numeric Arguments 

Numeric arguments to the Position command are interpreted as 
single digit pixel vector specifiers. This supports programs 
which use "chain encoding" techniques and allows small relative 
changes in the drawing position. A sequence of pixel vector 
digits may be used, with accumulative results. The number of unit 
pixels actually moved for each digit is determined by the 
granularity (the unit distance) of the imposed coordinate space 
and the current pixel vector multiplier value as set by the 
writing options instruction. 
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8. 5. 2. 3 Quoted String Arguments 

There is no defined meaning for quoted text as an argument to the 
Position command in Base ReGIS. 

8. 5. 2. 4 Options 

8. 5. 2. 4.1 P(B), P(E), and P(S) - Position stack operations 

The position begin and end options allow a simple means for 
recording a current position value and then recovering that value 
at some later point in the instruction stream. The P(B) option 
saves the current value of X and Y on the position stack. Should 
subsequent drawing or positioning instructions change the drawing 
position, execution of the P(E) option causes the drawing position 
to be restored to the saved value. This helps define images which 
are to have maximum transportability, since it allows accumulative 
roundoff errors to be occasionally eliminated, particularly in the 
case of text drawing which may be very roughly approximated on low 
resolution devices. 

The construct P(S) is provided for symmetry with the V(S) and C(S) 
position constructs. P(S) saves a dummy entry on the position 
stack. This entry, when recovered by a P(E), performs no action 
beyond incrementing the stack pointer to pop the dummy entry. In 
this way, the same drawing positions will be visited by Position, 
Vector, and open Curve instructions executing the same parameter 
sequence . 

The position stack is cleared to no entries on the execution of 
S(E) or when a valid S(A) is executed. 

8. 5. 2. 4. 2 P(W) - temporary Write options 

The W option to any of the drawing action commands temporarily 
changes the write attributes to the specified values for the 
extent of the instruction in which it occurs. Temporary write 
options revert to their previous state upon the occurrence of a 
new command keyletter (not necessarily different from the one in 
effect) or when the interpreter is brought to command level by 
synchronization, such as by encountering a semicolon. 

Suboptions to the P(W( ) ) form are the same as for the W( ) command 
itself. The only meaningful suboption in the context of the 
Position command is the pixel vector multiplier, that is, 
P(W(M<m>)). 
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8.5.3 WRITING ATTRIBUTES INSTRUCTION 

The writing attributes instruction, keyletter "W", provides 
controls under which the image is to be drawn. In the ReGIS Base 
this includes the selection of line drawing patterns and the 
adjustment of pixel vector sizes. Extensions to ReGIS add 
controls for color, intensity, and drawing modes, among other 
features. 


8. 5. 3.1 Position Arguments 

There is no assigned meaning for bracketed position arguments to 
the Write attributes command in Base ReGIS. 

8. 5. 3. 2 Numeric Arguments 

There is no assigned meaning for numeric arguments to the Write 
attributes command in Base ReGIS. 

8. 5. 3. 3 Quoted Text Arguments 

There is no assigned meaning for quoted text arguments to the 
Write attributes command in Base ReGIS. 

8. 5. 3. 4 Options 

8.5. 3. 4.1 W(M) - Pixel Vector Multiplier 

The M option to the attributes command defines the pixel vector 
multiplier that apply to pixel vector arguments. These pixel 
vector arguments apply to the commands which interpret numeric 
arguments as addressing constructs. A numeric argument is a 
multiplicative scale factor to be applied to the default pixel 
size set by the S(A) command. It may be a floating point value in 
systems which support floating point arithmetic, but may be 
truncated to an integer in systems which do not. A value of 0 is 
taken to be 1. There is no upper bound on legal values for the 
numeric argument other than that imposed by the base arithmetic 
limits of the ReGIS interpreter (16 bit integer arithmetic). 

The pixel vector multiplier is set to 1 when a valid S(A) is 
executed. 

8. 5. 3. 4. 2 W( P<n> ( <suboption> ) ) - line Pattern definition 

The ReGIS Base does not require that devices draw in color or gray 
scale, as these attributes do not transport easily across devices. 
The Base ReGIS definition assumes that lines can be presented 
which differ by line style, that is, dashed, dotted, solid, and so 
on. There are ten predefined line drawing patterns, and ReGIS 
supports bit by bit definition of custom drawing patterns. A 
single digit argument to the P option selects a line style from 
the following list. 
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PO - no visible foreground image specified 

Pi - Solid line 

P2 - Dash pattern 

P3 - Dash dot pattern 

P4 - Dot pattern 

P5 - Dash dot dot pattern 

P6 - Sparse dot pattern 

P7 - Asymmetrical sparse dot pattern 

P8 - Sparse dash dot pattern 

p 9 - Sparse dash dot pattern 

Pi is the default line drawing style. 

When the numeric argument is a string of binary digits (decimal 
ones and zeros), the argument represents a bit by bit definition 
of a custom pattern. Base ReGIS interprets the user defined 
pattern as a sequence of line segments based upon an alternating 
pattern of PO and Pi line types. For example, the sequence 

PlllOlO 


constructs a Dash Dot pattern similar to the P3 line type. 


Digit arguments to the (P) option are treated individually. If a 
digit string consists entirely of ones and zeros, then it is 
interpreted as a binary pattern specification. Any other single 
digit specifies one of the line patterns 2 through 9 noted above. 
The last such digit in a sequence of digits selects the 
appropriate pattern. 

These standard patterns 2 through 9 are represented in an eight 
bit pattern length as; 


2 

3 

4 

5 

6 

7 

8 
9 


11110000 

11100100 

10101010 

11101010 

10001000 

10000100 

11001000 

10000110 


Dash pattern 

Dash dot pattern 

Dot pattern 

Dash dot dot pattern 

Sparse dot pattern 

Asymmetric sparse dot pattern 

Sparse dash dot pattern 

Sparse dash dot pattern 


The length of the units of the pattern elements is not specified, 
nor is the relationship of the lengths of the "dashes" and "dots." 
In raster devices, the unit dot may typically be the size of the 
physical pixel, but there is no requirement that this length be 
coupled to any absolutes of screen addressing. Therefore, only 
the "duty cycle" of the patterns, not their component lengths, is 
guaranteed by this standard. 
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Each device must have a certain repetition length for the line 
drawing patterns. This length is not standardized since a basic 
dot pattern will carry essentially the same information content 
independent of this repetition period. If the number of binary 
digits specified exceeds the implemented width <k>, then the 
implementor may choose to keep either the first <k> bits specified 
or the last <k> bits specified, at his option. 

Conforming software should use only the standardized patterns 
(with multipliers to expand the distinguishable range of patterns) 
unless the details of the pattern register in the device being 
driven are known. 

Patterns specified should repeat within the repetition length of 
the device. In this way predefined pattern Pi is identical to the 
custom pattern Pi. The action taken by the device in repeating 
patterns not a submultiple of its internal pattern length is not 
specified. 

The only defined suboption to the W(P()) command is M<m> , where 
the value <m> represents a multiplier to be applied to each 
element of the requested pattern, either predefined or custom. As 
noted above, the unit size of the pattern elements is not 
specified, but should be large enough to be easily distinguished, 
yet small enough to multiply well for scaled patterns. The 
multiplier value may be used to expand the pattern spacing, and 
thus achieve additional discernible line pattern types. 
Implementations must provide for multipliers as large as 16. 

There is to be no interaction between the pixel vector multiplier 
specified by W(M<n>) and the pattern element multiplier 
W(P(M<m>) ) . 

The line pattern is reset to solid and the pattern element 
multiplier is set to 2 when a valid S(A) is executed. 
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8. 5. 3. 5 Writing Modes 

As was noted at the start of this section, the only Writing 
Attributes required in Base ReGIS are those for the control of 
line pattern and pixel vector length. Extensions to ReGIS provide 
for other controls, among them the writing mode, that is, how new 
drawing actions affect the execution medium. Base ReGIS does not 
specify what writing mode must be present when these controls are 
not or cannot be implemented. The two most natural choices are 
either : 

1. Overlay mode, the model that most closely resembles 
writing with pen on paper, or 

2. Replace mode, a model which may be convenient for certain 
bitmap devices. 

Refer to subheadings 8.7.2 Raster Extension and 8. 7. 2. 4.1 Writing 
Attributes Extensions - Writing Mode Options. for a complete 
definition of writing modes. The guiding criterion to the device 
implementor is that visible output is generated. 
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8.5.4 VECTOR INSTRUCTION 

The Vector instruction, keyletter "V", draws straight line 
segments connecting the current drawing position and one or more 
specified positions. It uses bracketed position arguments or 
pixel vectors. 

8. 5. 4.1 Arguments 

Semantically, the vector instruction is exactly the same as the 
Position instruction, with the exception that the V instruction 
can cause a visible image to be generated. The lines drawn by 
this instruction are subject to the current line drawing pattern 
selected by the W instruction and the pixel vectors drawn are 
subject to the current pixel vector multipliers selected by the W 
instruction. 

The B and E options allow the user to define a closed polygon, 

I though this is not the mechanism used in ReGIS to specify a filled 
I polygon. Refer to the section on Position instruction options, 
and the section on the position stack, for detailed descriptions 
of the use of the B and E options. 

The S option to the Vector instruction is included to provide 
symmetry with the open Curve instruction. An S option to a vector 
or position instruction saves a dummy entry on the position stack, 
consuming one entry of stack space. The matching E option to this 
S pops the dummy element from the stack without other effect. 
This dummy element will cause the same action as would be achieved 
by trying to pop from the empty stack, except that any data below 
the dummy entry is still valid and available. The dummy entry 
implies NO ELEMENT, as contrasted with the empty bracket ( t 1 ) » 
which implies action at the current position. This allows vector 
and open curve sequences to use exactly the same argument list to 
achieve parallel results. Note that the position stack available 
to the Vector instruction is not available to the Curve 
instruction. These parallels are parallels of semantics, not of 
shared or shareable state. Refer to the C(B), C(E) and C(S) 
sections later in this standard for descriptions of closed and 
open curve actions. 

The W option allows the writing attributes to be temporarily set. 
After completion of the Vector instruction, the value of the 
writing attributes returns to those they had before the execution 
of the V instruction. 
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8.5.5 CURVE INSTRUCTION 

The Curve instruction, keyletter "C," draws circles, arcs of 
circles, and interpolated curve sequences. "Interpolated Curve 
Sequence" means a curved line image of varying radius of curvature 
such as a draftsman using French curves or similar aids would 
draw. 

A Curve construct in Base ReGIS has been included for the 
following reasons: 

a. Each graphic device knows its abilities better than the 
software driving the device, and thus is better able to 
select an optimal quality versus performance tradeoff. 
This avoids the problem which arises when software 
approximates a circle by specifying an 18 sided polygon 
for use on a low resolution device, and produces an 18 
sided polygon precisely when the application is run on a 
high resolution device. 

b. With the assumption that all devices will have local 
processors, there is no longer any significant complexity 
to having a local curve capability. 

c. The availability of a local curve capability can 

substantially reduce the number of characters transmitted 
to the device . 

d. The inclusion of a curve capability gives ReGIS a degree 
of completeness in terms of incorporating the "rule and 
compass" drawing primitives. 


Circles vs. Curves 

While both circles and general curve constructs 
are defined as parts of the same ReGIS commands, 
differences are great enough in goals and actions 
of the commands that they should be considered as 
separate commands for purposes of explanation. 
Hence, the description of the actions of the 
argument types below is divided into a circle set, 
a curve set, and a common set. The results of 
mixing circle options (C and A) with curve options 
(B, S, and E) in the same command are not 
specified, and should be considered an error. 
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8. 5. 5.1 Position Arguments 

The meaning of a position argument depends upon whether or not a 
curve position block has been selected. 

8. 5. 5. 1.1 Circles 

Outside of a position block, position arguments mean "draw a 
circle" or, if the arc-angle option has been selected, "draw an 
arc of a circle." The instruction form C[ <position> ] draws a 
circle with the current drawing position as the center and 
[<position>] a point on the circumference of that circle. The 
drawing position is left at the center after the circle is drawn; 
that is, the drawing position is unchanged. 

Thus, consecutive [<position>] arguments to a C command causes 
concentric circles to be drawn. The (C) option inverts the 
relationship of the initial drawing position and the position 
arguments. 

If the arc-angle option (A<ang>) is used, an arc of a circle is 
drawn starting at the point on the circumference and ending <ang> 
degrees from that point. 

8. 5. 5. 1.2 Curves 

Within a position block, position arguments refer to points on a 
curve through which an interpolated curve is to be drawn. S and B 
represent the two types of curve interpolation sequences. The S 
option specifies an open end point curve. The B option specifies 
a bounded curve, in which the end point of the interpolated curve 
is drawn back to the beginning point to form a smooth closed 
curve . 

8. 5. 5. 2 Numeric Arguments 

Numeric arguments to both forms of the Curve command are 
interpreted as pixel vectors. The pixel vector specifier shall be 
interpreted as if it were a relative bracketed extent, and 
executed in the circle or curve context, as appropriate. For 
instance, CO « C[+m] where m is the current pixel vector 
multiplier. If m - 10, then CO draws the circle just as if it 
were C[+10]. The pixel vector multiplier should be set to a 
reasonably large value for these vectors to have worthwhile 
effect . 


8. 5. 5. 3 Quoted String Arguments 

There is no meaning defined for any quoted string arguments to the 
Circle or Curve command in Base ReGIS. 
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8. 5. 5. 4 Options 

8. 5. 5.4.1 Circles 

8. 5. 5. 4. 1.1 C(A<ang>) - Circular Arc 

The circular arc option causes only a portion of the specified 
circle to be drawn. The current drawing position specifies the 
center of the arc, and a position argument or pixel vector 
argument specifies the start point of the arc. The arc is drawn 
<ang> degrees, counterclockwise for positive <ang>, clockwise for 
a negative <ang>. Arc directions, clockwise and counterclockwise, 
are referenced against the viewing reference, that is, as seen by 
the viewer. Inverting the address space by changing the sense 
defined in S(A) does not change angle orientation. 

The accuracy to which <ang> may be specified is device dependent. 
It is based on the methods and computational resources available 
in the device. ReGIS devices are allowed to round angular 
specifiers to the nearest 10 degree increment, rounding up to the 
next 10 degree increment at the five degree point. Where 
consecutive arcs are a requirement, as for drawing pie charts and 
the like, careful applications should specify arcs rounded down to 
the next lower increment of 10 degrees, and complete the arc by 
one or more vector segments to more closely reach the idealized 
end point. 

Should the absolute value of the specified angle exceed 360 
degrees, the value executed will be plus or minus 360 degrees, as 
appropriate . 

The drawing position is left at the end point of the arc if the 
(C) option was used. Otherwise, the drawing position is left at 
the center of the arc. 

8. 5. 5. 4. 1.2 C(C) - Circumferential Circle 

The (C) option to the circle command causes the relationship 
between the current drawing position and specified position 
arguments to be inverted. When the (C) option is in effect, the 
current position defines a spoint on the circumference, and a 
position argument or pixel vector specifier indicates the center 
of the circle or arc. 

A circle command with the (C) option draws the circle with the 
current drawing position as a point on the circumference and 
[<position>] as the center. In this case, the drawing position is 
left on the circumference of the circle at the the end point of 
the circle drawing. 
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The (C) and (A) options to the Circle command may be used 
together, as illustrated by Figure 8-5. In this case, the drawing 
position defines the start point of the arc, and is left at the 
end of the arc when it is completed. 


X initial drawing position 
4. ending drawing position 
a spac'd position argument 




C(CA90) [-120, +301 



C(CA-150) [-125] 


Figure 8-5: Circumferential Circle and Arcs 


8 . 5 . 5 . 4 . 2 Curves 


8. 5. 5. 4. 2.1 C (B) , C(E), and C(S) - Curve interpolation 

Either the option "S" (for an open curve sequence) or "B" (for a 
bounded curve) starts a general curve interpolation sequence. The 
sequence ends with the "E" (end) option. There must be no 
intervening circle or block structured P or V instructions within 
the range of a curve begin-end sequence, nor shall C(S) ... (E) or 
C (B) ... (E) sequences be nested. (Curve and circle operations may 
be present within a vector or position (B) (E) block, however.) 
Within these option specifiers, the position arguments (starting 
with the current drawing position) represent points through which 
a smooth curve image is drawn. 


An open or closed curve interpolation must be completed within one 
invocation of the C command, or the state of the interpolation may 
be lost. Note that in the command stream 


C(B) []C[]C[]C[] . . . 

the intent seems to be that a closed curve sequence be invoked. 
The occurrence of the second C in this streaim returns the ReGIS 
parser to command level, however, voiding the actions of the (B) 
option and resulting in some number of concentric circles. 
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The only three elements allowed within a curve interpolation 
sequence, either open or closed, are: 

1. Position elements (bracketed or pixel vector) 

2. Options (some of which may have no meaning within a curve 
construct) 

3. Text arguments (which cause a skip state and are ignored) 


Any new command keyletter, even a reiteration of the C command 
keyletter, results in the abnormal termination of the curve 
context, and the curve state is lost. Termination of curve 
context by a synchronizing semicolon has the same effect. In 
either case the number of curve elements drawn is device 
dependent. Thus, conforming software should always properly 
terminate a curve construct to ensure consistent visible results. 

The use of (W( ) ) suboptions in curve interpolation commands is 
similarly device dependent. Given the allowed variability of 
curve interpolation algorithms, prediction of what writing mode or 
rendition will be coupled with what curve segment is beyond the 
scope of this standard. 

The algorithms used and the drawing methods employed to execute 
open and closed curves are not prescribed by this standard. The 
intent of this standard is not to prescribe a class of curves by 
definition (as, say, "cubic spline" or "conic approximation"). 
The following constraints do apply, however, and may limit the 
practical choice of algorithms: 


a. The curve must pass through every point specified in the 
argument list with the same accuracy that a vector would 
pass through them (zero-order continuity). 

b. The slope of the curve must be continuous across every 
specified point (first order continuity). Furthermore, 
the slope of the curve at any given point in the argument 
list must be parallel to the line connecting the previous 
and subsequent adjacent points in the argument list. 

c. Four or more collinear points must result in a straight 
line from the second to the next to last of these four 
points. This is a necessary result of constraints 1 and 

2 . 

d. Intermediate computed points found for the curve must be 

the same regardless of the direction in which the points 
are specified, that is, whether the points defining it 
are given from l..n or from n..l. This does not mean 
that the visible results must coincide, since this 
constraint does not impose a method of rasterization on 
the line segments which connect these intermediate 

points . 
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The slope constraint above leads to an indeterminacy of slope af 
the first and last points on an open curve. For a closed curve 
(option B), the point information at the beginning of the sequence 
must be retained by the ReGIS interpreter so that the closed curve 
will have a continuous first derivative at the end point. 
Determining the slope of open curves at the end points is handled 
in the following manner: 

o The curve segments from the start to the second point and 
from the penultimate to the last point are not drawn. 
These point pairs (first and third, and second next to 
last and last) are used to define the slope of the curve 
at the second and penultimate points. 

o The begin and end points may be visually included in the 
curve by using the "null” point syntax [] to indicate 
that the point is to be repeated in the sequence. In 
this case, the visual appearance of the curve at the end 
points may not be realistic, since the effects of 
doubling the end points bypasses the natural constraint 
of first order continuity and the intended shape of the 
curve . 


As a result of these constraints and conditions, at least three 
position arguments in addition to the current cursor position must 
be given to result in a visible curve segment between the second 
and third positions (the first position being the initial drawing 
position). One additional curve segment is then drawn for each 
additional position argument. 

For open curves, the current cursor position is always maintained 
at the last position argument given and thus leads the drawing 
process by one curve segment. For closed curves, the drawing 
position at the end of a closed curve command is not changed as a 
result of curve drawing. The value of the drawing position 
resulting from abnormal termination of a curve interpolation 
sequence, as by sending a parser synchronizing sequence, is not 
standardized and is thus device dependent. 

Despite the definition of curve constraints outlined earlier in 
this section, ReGIS does not specify the exact algorithm by which 
devices will implement curve interpolation. The exact curve 
sequence drawn varies depending upon the algorithm used, but this 
is not considered a problem, since the essential information 
content is shown in spite of minor variations in the curve path. 
Devices may implement more than one curve interpolation algorithm; 
these algorithms may be user selectable by option extensions. 
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8 . 5 . 5 . 4 . 3 Common 

8. 5. 5. 4. 3.1 C(W) - temporary Write options 

The drawing style of the lines which make up the curve or circle 

are controlled by the settings of the Write attribute controls. 

These settings may be temporarily modified by the use of the W 
suboption, just as in the Vector instruction. 

8. 5. 5. 4. 4 Volatility of C Instruction Options 

All options to the Curve and Circle commands are temporary, and 

apply only within the scope of the instance of the C command 

keyletter in which they appear. Specifically, arc and 
circumferential circle specifiers apply to all position or pixel 
specifiers that follow it until: 

a. These options are respecified. 

b. A new keyletter is encountered. 

c. The interpreter is synchronized to command level. 
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8.5.6 TEXT INSTRUCTION 

The graphic text instruction, keyletter "T", draws strings of 
characters starting at the current drawing position. 

Each ReGIS device must have a built in character definition and 
I writing capability. The default alphabet for writing is a full 
I 8-bit encoded printing set, typically ASCII or some other base set 
I in GL, and some supplemental set in GR. The recommended default 
I and initial contents of the in-use table is ASCII in GL and ISO 
I Latin-1 Supplemental in GR. For products targeted for use in 
I areas where these sets are not reasonable defaults, 

I product-dependent initial and default values are allowed. 

Each character of the text string is written by placing the visual 
I image of the referenced character at the current drawing position 
I such that the upper left corner of the character cell coincides 
I with the current drawing position. After writing the character, 
the drawing position changes to a point which would be the logical 
position for writing another character, normally horizontally a 
distance a little more than the visual width of a character. In 
an extended system, the color or intensity of text is determined 
by the setting of the Write attributes, W(I), just as are lines 
and curves. 

ReGIS does not specify the size of the text, its spacing, or the 
number of rows or columns of text which must be supported on a 
given display surface. ReGIS text is meant to be used 
annotatively, that is, to supplement the drawing process, not as a 
high density verbal display medium. 

Only the capabilities expected of low resolution devices are 
specified in Base ReGIS. Variable character size, orientation, 

I aspect ratio, and other factors are standardized in ReGIS 

extensions. Standard (default) character sizes are not defined by 
the ReGIS standard. Thus the drawing position resulting from the 
execution of a text string cannot be determined without knowledge 
of the target device or the detailed specification of text size 
and escapement. The quality of character representation at this 
level is also assumed to be poor and typically drawn as a sequence 
of short vectors or as a pixel pattern. 

I ReGIS does not have the facility to choose among alternate 

I typestyles (fonts) that may be stored in a device. ReGIS 

I extensions do support the idea of down-line loadable character 

I sets, which may be used to implement such a capability. 
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8. 5. 6.1 Position Arguments 

A position argument to the Text command specifies character 
escapement, that is, how much the drawing position moves after a 
character has been drawn. This measure is expressed in units of 
the imposed coordinate space. It defaults to rightward movement 
equal to the current width of the character display cell, and no 
vertical movement. This character to character movement defines 
what is known as "character path," and describes the orientation 
of the entire character string. It should not be confused with, 
nor does it affect, the orientation of the character cell 
baseline, which is not controllable in Base ReGIS, but is covered 
in ReGIS extentions. The presence of a bracketed argument to the 
T command is non-positional . Refer to the subheading 8. 4. 5. 2 Use 
of Bracketed Extents for Non-Positional Information. This value 
is always considered relative, regardless of the presence or 
absence of sign characters on the X and Y parts. Any missing 
elements are interpreted as +0, that is, no escapement in that 
dimension. If character size options are supported, they also set 
character escapement as a side effect. 

Character escapement is returned to its default value when a valid 
S(A) operation is executed. 

8. 5. 6. 2 Numeric Arguments 

Numeric arguments to the Text command are interpreted as a form of 
pixel vector, and cause special motion of the drawing point. This 
motion is equal to half the current character size. When 
character height and width are not equal, this movement will take 
on the proportions of the character cell. 

Movement is executed only when the pixel vector digit is 
encountered, and does not affect, nor is it affected by, the 
character escapement value. The direction of the 0 pixel vector 
is parallel to, and in the direction of, the character baseline. 
(This reference is significant in ReGIS extensions, where the 
character baseline is not constrained to be parallel to the 
horizontal axis.) Numbers 1 through 7 step in equal increments, 
counterclockwise, as for normal pixel vectors. This argument can 
be used for superscripting and subscripting in text strings. 

8. 5. 6. 3 Quoted String Arguments 

Quoted string arguments to the Text command provide the character 
data to be displayed. Character patterns are retrieved from the 
stored alphabet (the iSst alphabet selected by T(A) if multiple 
alphabets are supported). AO is the default alphabet, and is the 
only alphabet required in Base ReGIS. The contents of the AO may 
be affected by state set external to ReGIS. 
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Only within quoted strings used as arguments to the Text command 
are any control characters interpreted. Only four codes are used: 
carriage return, line feed, backspace, and horizontal tab: 


I 1. The carriage return code resets the drawing position, 

I both horizontally and vertically, to the value it had at 

I the start of the current quoted text extent. 


2. The line feed code moves the drawing position down one 
character height unit vertically, and saves this new 
position as that which will be restored should a carriage 
return code be subsequently encountered in the current 
quoted extent. 

3. The backspace code moves the drawing position back one 

character escapement step, both horizontally and 

vertically. 

4. The horizontal tab code moves the drawing position 
forward one character position, just as a space character 
would, but without drawing anything. The distinction 
between drawing a space and just moving the drawing 
position is significant when different drawing modes are 
considered. A replace mode space executes the background 
color into the drawing medium, while an overlay mode 
space or a horizontal tab in any mode do not. 


8. 5. 6. 4 Options 

8. 5. 6. 4.1 T(A) - Alphabet selection 

Arguments to the Text instruction select among possible alphabets 
of characters. Extensions to ReGIS specify loadable alphabets. 
The only selection mechanisms in the ReGIS Base are among 
pre-loaded alternate character sets. 

The T(A) command has suboptions R and L, each of which takes a 
quoted string argument, the tail of the reformatted ANSI 
designating escape sequence. The resulting format is 

T(A<n>( L"<designating tail>")) 

to select a character set into the left half, and 

T( A<n>( R"<designating tail>")) 

to select a character set into the right half. 
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Under the formats established by ISO 2022, a sequence of the form 

ESC I ... I F 

is a character set designating sequence if the first intermediate 
(I) is from certain code positions in column 2 of the code table. 
This first intermediate identifies the type of character set and 
its G-set (GO, Gl, G2, or G3) assignment. By replacing this 
particular intermediate with a character from column 3 of the 
table, the G-set assignment is ignored but identification of the 
character set type is retained. This technique is used in the DEC 
Common Font File Format (CFFF) for identifying character sets 
where G-set assignment is not a factor. The "tail" of the 
resulting sequence is everything except the introducing ESCAPE 
code. Without the ESCAPE code, the tail is clear text, and can be 
used as a string-type argument. 

The designating tail in the quoted argument to L and R must start 
with a legal first intermediate as noted in either of the two 
tables below. An incomplete or illegal tail will be ignored. 
There may be multiple tails in a single quoted argument, as 
multiple tails may be required to couple a character set selection 
with a version number tail, or to list alternative designations in 
a single command. 

The following table lists the legal first intermediates (the 
"column two" intermediates) used in the normal character set 
selection scheme. 

Code Graphic Use 


2/4 $ multi-byte set 

2/6 & version number 

2/8 ( 94 character set, GO 

2/9 ) 94 character set, Gl 

2/10 * 94 character set, G2 

2/11 + 94 character set, G3 

2/13 - 96 character set, Gl 

2/14 . 96 character set, G2 

2/15 / 96 character set, G3 

This table lists the replacement intermediates (the "column three" 
intermediates) and their resulting character set assignments. 

Code Graphic Use 


3/0 0 

3/1 1 

3/2 2 

3/3 3 

3/4 4 

3/5 5 


94 character set 
96 character set 
multi-byte 94 character set 
multi-byte 96 character set 
complete code character set 
character set revision 
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ReGIS has a single 8-bit in-use table with left and right halves. 
Use of these "new" intermediates from column 3 allows the 
categorization implied by G0-G3 to be ignored. ThuS/ the 
character set shifting controls, such as Shift In (SI), Shift Out 
(SO), Single Shifts (SSn), and Locking Shifts (LSn, LSnL and LSnR) 
are not supported. This is true regardless of which tail format 
is chosen. 

The character sets listed in the following table are required to 
be supported in all ReGIS implementations. The indicated 
designating tails are the column three tails, and are the 
preferred tails for use by new ReGIS creators. The older column 
two tails are allowed, but their use should be phased out. 

Tail Name of set/Source standard 


00 DEC Special Graphics 

04 DEC Dutch NRCS (optional) 

05 DEC Finnish NRCS 

07 DEC Swedish NRCS 

09 DEC French-Canadian NRCS 

0- DEC Swiss NRCS 

0> DEC Technical 

OA British NRCS/BS 4730 

OB ASCII/ANSI X3. 4-1986 

01 JIS Katakana/JiS X 0201 

OJ JIS Roman/JIS X 0201 

OK German NRCS/DIN 66 003 

OR French NRCS/AFNOR NF Z 62-010 [1973] 

OY ISO Italian NRCS 

OZ ISO Spanish NRCS 

O' Norwegian/Danish NRCS/NS 4551-1, DS 2089 ' 

0%5 DEC Supplemental/DEC STD 169 

0%6 DEC Portuguese NRCS 

lA ISO Latin Alphabet Nr 1 Supplemental 

"Latin-1" is an allowed synonym for "Latin Alphabet Nr 1." DEC 
Dutch is not required to be supported in ReGIS, but '04' is the 
approved tail if it is supported. 


ReGIS devices supporting the Kanji Display Extension must also 
support the following character sets and designators. 


Tail 

Name 

1 of set/Source 

standard 

20 

DEC 

Kanji 

1978 


22 

DEC 

Kanji 

1983 


2@ 

JIS 

Kanji 

1978/JIS 

X0208-1978 

2@ 

JIS 

Kanji 

1983/JIS 

X0208-1983 
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The default state of the ReGIS character set table shall be that 
specified by the command 

T(A(L"0B”,R"1A’' ) ) , 

This is equivalent to the 8-bit set Latin-1. 

The command 

T(A(L"0J",R'’0l") ) 

puts JIS (Japanese) Roman in the left half and JIS Katakana in the 
right half of the ReGIS in-use table. 

This selection methodology extends to multi-byte support. 

The command 

T(A(L"( J",R"$+@") ) 

uses the column two tails and selects JIS Roman into the left half 
and JIS X0208 (Kanji) into the right. 

The command 


T(A(R"5AlA" ) ) 

uses a multiple tail to modify the selection of a multinational 
character set into the right half by preceding the Latin-1 
Supplemental tail with a version identifying tail. The above 
sequence would specify the second revision of the ISO Latin-1 set. 
[This is just an example - as far as is known, the first revision 
hasn't even been considered yet.] 
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8.5.7 REPORT INSTRUCTION 

The Report function is included to allow the user software to 
interrogate the ReGIS device for state elements of interest. 

8. 5. 7.1 Position Arguments 

There is no meaning assigned to bracketed position arguments to 
the Report command in Base ReGIS. 

8. 5. 7. 2 Numeric Arguments 

There is no meaning assigned to numeric arguments to the Report 
command in Base ReGIS. 

8. 5. 7. 3 Quoted String Arguments 

There is no meaning assigned to quoted string arguments to the 
Report command in Base ReGIS. 

8. 5. 7. 4 Options 

8. 5. 7. 4.1 R(M(x)) - Report Macrograph state 

The contents of an individual macrograph is reported back to the 
controlling program by specifying the M option to the R command 
with a suboption keyletter which is the same as the name of the 
desired macrograph. 

The format of the report is 

@=<name><string>@ ; 

which parallels the format of the macrograph definition, with the 
substitution of an equal sign (=) for the colon (:). 

In some systems, unrestricted allowance for reporting of 
macrograph contents will sometimes result in system security 
problems. Devices are therefore allowed the freedom to restrict 
macrograph reports. The preferred fallback is the empty report, 
that is, just the terminating CR character. 

An alternative is to report the macrograph as specified above, 
replacing each character in the macrograph with SPACE or some 
other printing character. This allows the user to verify the 
length of the stored macrograph, and might indicate the proper 
storage of the macrograph in question. 
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The macrograph storage allocation may be returned by specifying 
the command 

R(M(=)) 

which returns a quoted string of the form 

"<f ree>,<total>" 

where <free> is the minimum guaranteed amount of space, in 
characters, still available for macrograph storage, and <totai> is 
the amount of space, in characters, allocated by the device for 
macrograph storage. It is not required that "<free>" be accurate 
to the character count level, as long as its value represents a 
lower bound on the measure of available space. 

8. 5. 7. 4. 2 R(P) - Report current Position 

The returned report is a bracketed position specifier of the form 

tx,y] 

representing the current drawing position in the imposed 
I coordinate system. The parts, x and y, return in ReGiS-conforming 
I numeric representations. 

If the drawing position has been moved into absolute negative 
coordinate space, the format of the report includes a signed 
number indicating this. Hence, in position reports signed numbers 
represent absolute, not relative, locations. 

8. 5. 7. 5 Further Notes 

All reports are terminated by a single carriage return character. 
Requests for unimplemented reports are acknowledged by the 
device's returning just a carriage return; this prevents device 
deadlocks by ensuring that an application will receive some 
response, even if the requested report cannot be generated. 

Multiple options or suboptions to a single R command are 

interpreted as requests for multiple reports. 

All devices must return a report for every option keyletter in the 
argument stream. Some forms of the report command define a report 
for every suboption letter as well, as is the case with macrograph 
reports . 

In the case of unimplemented reports, the device may not be able 

to discern how many reports are due, especially if suboptions are 

involved (as in the case of the macrograph report). Hence, 
software should request reports singly and in turn, so that only 
one report response is outstanding at any time. This will 

minimize the chance of deadlock or phase error due to unanswered 
reports. 


BSIDDSD' 


Digital Internal Use Only 



EL-00070-08 31-Mar-1988 

VSRM - ReGIS GRAPHICS EXTENSION 


Page 8-89 


There are some classes of devices for which reports are not 
necessary or easily supported. Software to convert ReGIS files to 
some other graphic form, for example, might not have an 
identifiable return path for reports. Some devices are meant to 
be run spooled, and will not have the ability to provide reports 
in a timely manner, if at all. 

Though the ReGIS Report command is part of the ReGIS Base, it 
clearly cannot be supported in all environments. Lack of support 
for Reports in such environments does not constitute a failure to 
conform to the ReGIS standard. 
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8.5.8 FILL INSTRUCTION 

The Fill instruction, keyletter "F", defines bounded areas by 
their edges. The command colors in only and entirely, subject to 
area texture or pattern in effect, the area (or areas) bounded by 
the edges presented. 

8. 5. 8.1 Position Arguments 

There is no meaning assigned for bracketed position arguments to 
the Fill instruction in Base ReGIS. 

8. 5. 8. 2 Numeric Arguments 

There is no meaning assigned for numeric arguments to the Fill 
instruction in Base ReGIS. 

8. 5. 8. 3 Quoted Text Arguments 

There is no meaning assigned for quoted text arguments to the Fill 
instruction in Base ReGIS. 

8. 5. 8. 4 Options 

8. 5. 8. 4.1 F(C, P, V ) - define filled area 

The actions of the P, C, and V commands inside the option extent 
of a Fill command mimic the actions of the Position, Curve/Circle, 
and Vector commands at command level. Instead of executing 
positions and drawing lines to outline an area or shape, these 
options define the extent of whatever figure would be drawn at 


command 

area. 

level, and cause 

that 

area 

to be executed as 

a filled 

Each P, 

C, or V option 

to 

the 

F 

command takes 

whatever 

subarguments that would 

apply 

at 

the 

command level to 

define a 


shape and use that same argument in the context of executing the 
figure as filled, subject to some of the following constraints. 

a. Allowable suboptions V and P are stack controls V(B,E,S) 
and P{B,E,S); for C, closed and open curves, C(B,S,E), 
and arcs and circumferential arcs and circles, C(A,C). 

b. Write suboptions are allowable for all of V, P, and C in 
contexts where they make sense, as described in later 
sections. 

c. Allowable arguments for V, P, and C are bracketed 
position specifiers and pixel vectors. 
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The definition of a polygon boundary is determined by the edges 
described by the drawing options V, P, and C. These edges are 
determined by what would be drawn by the V and C options were they 
executed at command level. The P option modifies how position 
arguments to V and C may be interpreted, but no position specifier 
on a P option will be entered into the list of vertex list which 
describes the border. This implies that the current position in 
effect at the start of a polygon description is NOT automatically 
the first vertex of the defined polygon. If the current drawing 
position is meant to be that vertex, then an option specifier such 
as V( ] (the empty brackets implying current position) must be the 
first executed position. The termination (closure) of the Fill 
command will close the polygon to this point. More explicit 
perhaps, is the form V(B) (with a matching V(E) at the 
termination) to apply the current position to start the polygon. 

During polygon outline definition the current position is updated 
as if the V, P, and C options to the F command were being executed 
outside of the F context. 

For Fill, no perimeter is drawn as a result of the boundary 
definition process or of the execution of the area defined. A 
perimeter, if desired, must be specified separately as a set of 
ReGIS commands (probably the same set, as macrographs are useful 
here ) . 

Each device has some implementation limit on the number of 
vertices which can be stored before the filled figure can be 
executed. A conforming ReGIS device must provide for a vertex 
list with a capacity of less than 256 entries, but note that 
certain other implementation dependencies with regard to curve 
interpolation (noted below) could result in many fewer than 256 
vertices available to software. (On the other hand, a device may 
save space in the vertex list by allowing consecutive vertices 
which map to the same physical pixel to be counted as a single 
vertex . ) 

If the number of vertices generated exceeds the implementation 
limit, any additional vertices are ignored and the figure is 
closed and filled as if it had been terminated at the 
implementation limit. 

The remaining elements in the fill specification will be ignored. 
No further drawing will be attempted until terminating right 
parenthesis of the Fill option list is encountered or a 
synchronizing action is executed. 

Polygon fill must accommodate non-convex and self-intersecting 
polygons. The interior of a polygon, that is, that area filled as 
a result of the polygon definition, is defined by the "even-odd 
rule," as follows- From any given point not on an edge of the 
defined polygon, consider a ray beginning at that point and 
extending in any direction to infinity. If that constructed ray 
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crosses an odd number of edges, then the specified point is inside 
the polygon, and it should take on the fill attributes of the 
polygon. If the ray intersects an even number of edges, the point 
is outside the defined polygon. Intersection of the ray with a 
vertex point or complete edge of the polygon provides information 
useful to resolve the even-odd rule only if the positions of 
vertexes adjacent to those intersected can be recognized as lying 
on the same side of the test ray or on opposites sides of it. If 
a ray intersects one or more vertex points, a new ray may have to 
be chosen. These rules suffice to distinguish the interior and 
the exterior of simple polygons, and also nested polygons, as may 
be described by the use of F(F), (a ReGIS Open extension for 
filling complex polygons). 

The current drawing position is saved at the beginning of an F 
command, and restored at the end of an F command, whether any 
drawing takes place or not. This behavior allows some degree of 
compatibility with older devices that do not implement the F 
command, and therefore simply ignore it. 

The state of the ReGIS position stack is not preserved by F 
commands. An implication of this activity is that position 
arguments may be passed into the polygon fill process by pushing 
them on the stack and popping them inside the fill process, and 
that position arguments may be passed out of the polygon fill 
process by pushing them inside and popping them after the Fill is 
complete . 

Any ReGIS command string that changes the state of the position 
stack within an F command will not be compatible with devices that 
do not implement the F command. A device that does not implement 
the F command will not recognize the V, P, and C options to the F 
command in their proper context, and hence cannot recognize stack 
operations in the option list either. 

The vertex list resulting from the interpretation of positional 
subarguments always represents a closed figure whether the drawing 
commands used to specify that vertex list represent a closed 
figure or not. If the commands used to specify a polygon do not 
represent a closed figure, for example, because of disconnected 
start condition on an open curve interpolation, the filling 
proceeds as if consecutive vertices had been connected by straight 
lines, possibly causing unexpected results. 
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Curve and arc interpolations may, depending upon the curve and 
circle algorithms chosen in a device, generate multiple vertices 
per specified point. Such intermediate points will have to be 
counted against the implementation limit of the vertex list of the 
polygon filling process if the device must save them to compute 
the filled area boundary. The implication of this is that devices 
may need an device-dependent number of entries in the vertex list 
to accommodate a given ReGIS area definition. Devices should 
provide a greater number of entries in the vertex list to mitigate 
the adverse effects of such curve algorithm dependencies. 

Open curves used to define polygon boundaries must abide by the 
constraints for such curves defined in the section on the Curve 
command. For such curves, the current position at the beginning 
of open curve interpolation does not generate any vertices, but 
helps determine the slope of the curve at the next specified 
point. The first specified point does not generate any vertices, 
since it is the beginning point of the curve. Subsequent 
specified points then generate some number of intermediate 
vertices each, as in normal (unfilled) curve interpolation. The 
last point specified does not generate any vertices; it determines 
the slope of the curve at the next-to-last point specified. Thus 
the total number of vertices generated when n points are specified 
for open curve interpolation is (n-2)*m, where m is the number of 
intermediate points per specified curve segment. 

In order to connect different types of open figures, such as V and 
C(A) sequences, it is sometimes necessary to use the P option to 
reset the current drawing position. Repositions via P may also be 
needed when it is desired to draw both a polygon and its outline 
using the same command string. 

Temporary write options may be specified as options of the of the 
F command itself, F(W...), or as temporary write suboptions to the 
C option, F(C(W...)), or V option, F(V(W...)). These forms are 
all equivalent and all supersede each other. Temporary write 
options are canceled by a new command keyletter. 

A right parenthesis at the option level terminates an option list 
and causes a filled polygon to be drawn. The filled polygon is 
drawn using the write options (including temporary write options) 
in effect at the time the right parenthesis is encountered. 

The only element of the write options which takes effect at the 
time it is encountered, rather than at polygon execution time, is 
the pixel vector multiplier, which conditions any pixel vectors 
used in defining the polygon boundary. 
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The area texture used to fill the polygon is variable by product 
classification. ReGIS devices that support the Raster Extensions 
use the interior style set by the area texture argument to the 
W(S) option, the same option used to enable shading. The 
"snapshot" of attributes established by enabling shading applies 
to polygon fill. An area texture is established by invoking 
shading and disabling it, as by the command fragments W(S1,S0) or 
W(S"x",S0). See subheading 8. 7. 2. 4. 2. 3, W(S) - Shading for a 
description of the shading snapshot. 

Devices that do not support the Raster Extensions may elect to 
fill with a solid color or intensity, or they may define a set of 
hatch patterns if solid fill is not appropriate. 

If a synchronizing semicolon is encountered (or external 
resynchronization occurs) before the terminating right 
parenthesis, the F command is aborted and no drawing takes place. 
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8.6 THE EXTENDED LOGICAL GRAPHICS DEVICE 

This section describes extensions to the Logical ReGIS Graphic 
Device required to accommodate specific graphical features not 
common to all devices. This section is an illustrative 
presentation to follow for extending ReGIS to device capabilities 
not described here. The case of raster CRT devices is covered in 
some detail to fully illustrate the process of extending ReGIS. 

8.6.1 DIMENSIONAL DISPLAYS 

"Dimensional displays" refers to the class of graphics devices in 
which the physical size of pixels has a repeatable meaning and 
allows the user a variety of pixel sizes. Examples of such 
devices include both paper and photographic plotting devices. 
ReGIS could be extended to accommodate these devices by allowing 
definition of the size of pixels in physical dimensions. 

By knowing the number of pixels selected by the screen coordinate 
definition operation and their size, the device is then able to 
determine the size of paper needed to draw the image. The units 
of the physical measure should be optionally selectable by the 
user, with the metric system being a likely default. 

These devices also will generally allow (and need) the width of 
line segments to be user controllable. This feature has been 
included in Open Extension to ReGIS as an option to the writing 
attributes instruction. 

8.6.2 GRAY SCALE AND COLOR 

The simplest model of color capability is that of a plotter device 
using different colored pens to draw on different colors of paper. 
In this case, the paper represents the background color and the 
pens represent the foreground colors. Monochrome devices often 
have the ability to show varying intensity levels of light, called 
gray scale. More complex devices, such as high resolution color 
raster devices, have the ability to present a full range of color 
hues in addition to the gray scale (intensity) capability. 
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8. 6. 2.1 Selection Scheme 

To accommodate this broad range of capabilities, the extended 
ReGIS logical device adopts a scheme to allow the selection of 
color and gray scale in a simple manner for simple devices, but 
still has full access to the broad spectrum of attributes of the 
most capable of the devices. 

a. Each pixel has associated with it a foreground and a 
background "intensity" attribute which are user 
controllable. The differentiation between foreground and 
background is most clear in the case of the plotter, and 
may have little meaning in a multiplane raster color 
device. 

b. For simple color devices, the scale of eight intensity 
values is interpreted as the three primary colors, the 
three complementary colors and the black and white 
intensity values. 

Mappings between gray scale and color should follow the 
conventions which have been established for photographic 
and broadcast television work. These are summarized as: 


Gray Scale Color Value 


0 

1 

2 

3 

4 

5 

6 
7 


Black (dark) 

Blue 

Red 

Magenta 

Green 

Cyan 

Yellow 

White 


This mapping is based on the standard RGB to luminance 
level transformation used in the North American 
television industry (NTSC color standard). The NTSC RGB 
to luminance equation is 

Y - 0.59*G + 0.30*R + 0.11*B 


where Y is the luminance value, and G, R, and B are the 
green, red, and blue components of the color drive, 
respectively. When normalized to the range 0 to 7, the 
equation becomes 

I - 4.1*G + 2.1*R + 0.8*B 

where I is the resulting gray scale intensity for that 
range. The coefficients (rounded to 4, 2, and 1, 
respectively) lead to the encoding of the table above. 
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c. For devices having a full range of color capability, the 
Hue-Lightness-Saturation system of color definition is 
adopted. In summary, this system requires three possibly 
floating point numbers to be used in defining a specific 
intensity parameter value. These are: 

- Hue (H) - the hue of the color expressed as an angle 
on the color wheel, 

- Lightness (L) - the relative brightness of the color 
expressed as a percentage of full brightness, and 
Saturation (S) - expressed as a percentage of the 
fully saturated hue. 


The intensity parameter may be applied independently to the 
foreground and to the background of the graphic image. Devices 
have extreme ranges of implementation of the intensity attributes. 
ReGIS does not define how many colors or intensity levels must be 
provided by an implementation which offers color or gray scale 
support. 


8. 6. 2. 2 Color Specification 

There are two methods of specifying color or intensity in a 
graphics device; color by index, and color by value. Color by 
index is often used in multiplane bit map displays, or in 
hard-copy devices whose pens are selected by number. Color by 
value is used by implementations which have limited knowledge of 
the drawing hardware being used, but which need to specify colors 
or intensities to differentiate image components. ReGIS supports 
both color by index and color by value. 


8. 6. 2. 2.1 Color by Index 


Virtually all graphics devices actually implement an indexed 
method of color selection. This index is translated into visible 
color by some hardware component, which may or may not be 
modifiable by user commands. Video devices, for example, 
translate the index value stored as bit map contents into beam 
intensity or color gun selector by a digital to analog converter 
and/or a multiplexer. If the converter/multiplexer is hard-wired, 
the translation is not user modifiable, and the translation from 
index to color is fixed. If the converter/multiplexer contains an 
extra stage of indirection to allow the translation to be dynamic, 
the device is said to have an output map. If this map can be used 
to modify the translation of index to color under user control, it 
is a truly dynamic system. In any case, ReGIS requires that the 
mapping of index values to visible components be known to the 
implementation. Colors by index may then be executed into the 
display medium directly. Color by value specifications are 
referenced against the index to color translation hardware (or 
software/firmware translation table) and a resulting index 
deduced. The index is then executed into the display medium as if 
it had been directly supplied. 
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In the case of an unsupported direct color or intensity specifier, 
the color map, whether hard-wired or user modifiable, should be 
searched to find the closest available color or intensity 
specifier. The "closest match" indicates the index value to be 
used. In monochrome systems, this "closest match" decoding is 
fairly simple, and either rounding or truncation may be used. The 
approach taken must be documented. 

In color systems, the concept of "closest match" is more complex. 
For example, if a degree of orange is requested but not supported, 
the goal should be to present some shade of red or yellow to 
approximate this request. If only shades of blue and green are 
available, however, the approximation has no clear solution 
Efforts should be made to prevent mismatches in requests for a 
foreground from collapsing to the background. If color mismatches 
are too great, matches based on the monochrome mappings of those 
colors might be used. The approach to be taken in such cases is 
device and device class dependent. 

In general, specification by index is implemented in ReGIS by the 
form 


I<index> 

where I is the suboption identifier for intensity for both the 
Screen command, where it sets the background color, and for the 
Write attributes command, where it sets the foreground. The range 
of values for <index> is device dependent. 

When an index exceeds the bounds of the device, the unimplemented 
index must be mapped back into the supported range. In systems 
which support only one visible color or intensity, any non-zero 
index should map to the visible value, and the zero index should 
remain zero. In systems with more than one bit of index 
specification, a modulus scheme should be used, wrapping out of 
bounds values back into the supported range in a non-monotonic 
mapping. For instance, given a 4-intensity implementation and an 
8-intensity stored picture, the following mapping would result: 


Ask Get 


0 0 

1 1 

2 2 

3 3 

4 0 

5 1 

6 2 

7 3 


The device class may determine whether the mapping is purely 
modular, or whether some other approach is more appropriate. 
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For example, in a multi-plane bit map, pure modulus arithmetic is 
the most straightforward. A three plane system can accept indices 
in the range 0 to 7, as noted in the example table above. Mapping 
into these three planes by accepting only the low three bits of 
values greater than 7 is acceptable, though collisions between the 
wrapped foreground and the background may occur. On the other 
hand, a pen plotter is less likely to present such a problem, 

since the color of the paper is not likely to be the same as one 
of the loaded pens. 

I 

I 8. 6. 2. 2. 2 Color by Value 

I 

Specification of color by value in ReGIS is more complex than 
color by index. Not only are colors more complex, but ReGIS 

supports two types of color specification, RGB and HLS. 

1. The HLS form is: 

I (H<ang>L<pct>S<pct> ) 

where I is the option to Screen and Write attributes 

commands as noted above, and H, L, and S are the HLS 
components noted earlier; <ang> is expressed in degrees, 
0 to 360; and <pct> in percentage values, 0 to 100. 

I A hue angle of zero degrees specifies blue, 120 degrees 

I specifies red, and 240 degrees specifies green. The 

I additive complementary colors magenta, yellow, and cyan, 

1 are positioned at 60, 180, and 300 degrees, respectively. 

2. The RGB form is: 

I(x) 

where x is a single letter color specifier for the RGB 
color alphabet: R, G, B, Y, C, M, W, or D for red, 

green, blue, yellow, cyan, magenta, white, or dark, 
respectively. 

Color suboptions must be completed within one suboption (one 
parenthesized range), and RGB and HLS color specifiers must not be 
mixed in the same suboption. RGB specifiers must not be 
quantified, nor may RGB specifiers be mixed to define color 
mixing. For example, the specifier RG does not imply Y. 
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HLS specifiers have the following defaults: 

a. If H or S is specified, but L is not specified or not 
quantified, L defaults to 50. 

b. If H is specified and quantified, and S is not specified 
or not quantified, S defaults to 100. 

c. If H is not specified or not quantified, S defaults to 0; 
H has no default. 

d. If none of H, L, or S is present, there is no default, 
and no action regarding that color specifier is taken. 

This rule will allow for extensions to the color 
specification alphabet by standardizing as yet 
unspecified suboption letters; the "no action" 
requirement protects backwards compatibility. 


Specification by index provides the most control over the device 
where the hardware use of the index can be known to the user, as 
in specifying plane-by-plane bit map contents. Specification by 
value provides the greater degree of transportability where the 
goal is to differentiate information and where the exact mapping 
of device capabilities is not known beforehand. 

8.6.3 TEXT ATTRIBUTES 


Text attributes include a wide variety of features associated with 
the presentation of textual characters, including (but not limited 
to) any combination of the following; 

a. Variable character size including independent width and 
height adjustment. 


I 


b. Variable character spacing including proportional spacing 
and letter-spacing. 

c. Angular orientation of characters and independent angular 
character spacing. 

d. National language character sets. 

e. Alternate representation fonts (Gothic, Futura, and so 
forth) . 


f. Superscript and subscript capability. 

g. Overstrike (underline, APL characters, and so forth). 
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ReGIS can be extended to support such features in extension sets. 
The user should recognize that the degree to which a specific 
device supports these characteristics is extremely broad .and is 
therefore one of the areas of image generation with the least 
portability. 

To support the majority of these features, an extended ReGIS 
device may support the definition of the following extended 
logical device parameters: 

1. WIDTH - The width of the hypothetical parallelogram in 
which a character is written. 

2. HEIGHT - The height of this parallelogram. 

3. DANG - The direction of the character base line measured 
as an angle in degrees relative to the horizontal axis. 

4. HANG - The direction of the height side of the character 

parallelogram measured relative to the baseline 

direction, such as relative slanting of characters, as 
for an Italic representation. 

5. TDX - The relative horizontal spacing of two characters. 

6. TDY - The relative vertical spacing of two characters. 

7. FONT - A scalar parameter used to identify which of 
several possible character representations is currently 
in use. 
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8.6.4 AREA ATTRIBUTES 

This class of extensions refers to the general capability of many 
devices to associate attributes to areas bounded by ReGIS 
primitive line images. The visual attributes may include shading 
patterns, similar in concept to line patterns, and color and 
intensity variation. 

These capabilities are covered syntactically by other ReGIS 

extensions. ReGIS distinguishes three approaches to identifying 
the boundaries of an area: 

1. SHADEd areas are defined to be the difference between two 
not-necessarily bounded vector or curve sequences. 

2. FILLed areas are defined by either a connected sequence 

of vectors or a closed curve, or by a combination of 

connected vectors and open and closed curves. 

3. FLOODed areas are defined by boundaries existing in an 

image without regard to what sequence of commands 

generated the elements of the boundary. 


The first case corresponds to the typical approach used to 
represent data as a "histogram" image. The second case 
corresponds to the common concept of bounded surface. The third 
case corresponds to after-the-fact coloring in of areas not 
necessarily bounded by a single command. 

8.6.5 DYNAMIC ATTRIBUTES 

The area of dynamic attributes covers a broad spectrum of features 
which are illustrated at one extreme by "blinking" attributes and 
at the other extreme by a fully animated cartoon. The common 
point in ReGIS for such capabilities is that the 
foreground/background selector function may vary as a function of 
time. Using this model, the typical blink attribute is 
interpreted as a time-based modification of foreground and/or 
background visual attributes, while more complicated dynamic 
attributes could be considered as selectors acting on separately 
accessible foregrounds. 
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8.7 REQUIRED EXTENSIONS FOR RASTER DEVICES 

This section describes a standard set of ReGIS instruction 
extensions to be used with raster CRT graphics devices. All 
commands under heading 8.5 Base ReGIS Instruction and all commands 
under this heading must be implemented as specified for a device 
to be certifiable as a ReGIS Raster Device. Heading 8.8 Open 
Extensions to ReGIS describes further extensions to ReGIS, some of 
which are applicable to raster technology, but which are not part 
of the required raster set. 

The additional capabilities addressed here include: 

a. Background and foreground gray scale and color intensity 
attributes, 

b. Image dependent writing attributes (complement), and 

other extended writing modes (replace, negate, and 

erase ) , 

c. Area attributes for bounded and unbounded areas, and 

d. Text attributes and user definable characters. 

All Base ReGIS commands apply to raster devices. Some raster 
commands modify or extend these base commands. Defaults for such 
new elements approximate as closely as possible the effects that 
would be achieved if the extension were not present. 

The original intent of ReGIS Raster Extensions was to capture the 
capabilities found in most raster video devices. Since the 
original adoption of ReGIS, monochrome bitonal raster printers 
have become a major presence in the industry. The ReGIS Raster 
Extensions focus on video-like capabilities, but the limitations 
of bitonal hard copy is considered as well. 
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8.7.1 SCREEN INSTRUCTION 

Raster scan extensions to the screen instruction allow setting a 
background intensity (color and/or gray scale value) and the 
introduction of a time base for ReGIS execution. 

8. 7. 1.1 Position Arguments 

There is no significance to the presence of a bracketed position 
argument in the Screen Instruction Extensions for Raster ReGIS. 

8. 7. 1.2 Numeric Arguments 

There is no significance to the presence of a numeric argument in 
the Screen Instruction Extensions for Raster ReGIS. 

8. 7. 1.3 Quoted Text Arguments 

There is no significance to the presence of quoted text arguments 
in the Screen Instruction Extensions for Raster ReGIS. 

8. 7. 1.4 Options 

8. 7. 1.4.1 S(A[][]) - Screen Address definition 

Display address definition in Raster Extensions works as it does 
in Base ReGIS, but sets to defaults the following Raster Extension 
state elements: 

a. The device writing mode is set to its device default. 

This is overlay, if possible, with replace as second 

choice. Negate mode is disabled. 

Equivalent explicit command: W(V,N0) or W(R,N0) 

b. Background color (or gray value) is set to its device 

dependent default; this default is visually distinct from 
the default foreground color or gray value. 

Equivalent explicit command: typically, S(I0); 

alternatively, S(I(<default color speo)) 

c. The foreground color (or gray value) is set to its device 
dependent default; this default is visually distinct from 
the default background color or gray value. 

Equivalent explicit command: typically, W(l<n>), n 

greater than 0; alternatively, W(I(<default color spec>)) 
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d. The foreground mask is set to all planes enabled. 

Equivalent explicit command: W(F<n>) with n«(2**m)-l, 

with m the number of planes in the device 

e. Shading state is set to disabled. 

Equivalent explicit command: W(S0) 

f. The text attribute set is set to restore individual text 
defaults if T(E) is encountered before T(B). 

g. Character baseline angle is set to horizontal. 

Equivalent explicit command: T(D0) 

h. Character unit cell and display cell sizes are set to the 
device dependent standard size 1. 

Equivalent explicit command: T(S[]U[]), with standard 

size 1 contents of the bracketed extents 

i. Character slant (italic) angle is set to rectilinear. 
Equivalent explicit command: T(I0) 

j. The alphabet selected for drawing is set to alphabet 0. 
Equivalent explicit command: T(A0) 

k. The alphabet selected for loading is set to alphabet 1, 
the first loadable alphabet. 

Equivalent explicit command: L(Al) 

The following states and stores are NOT AFFECTED by executing an 
S(A): 

l. The character stores are not affected. 

2. Character set names, as set by L( A' <name> ' ) , are not 
affected. 


8. 7. 1.4. 2 S(I<n>) Or S(I(<color specifier>)) - background 
Intensity 

The intensity parameter in the screen instruction uniformly 
changes the background intensity of the graphic image. The result 
is the same as loading a certain colored piece of paper into a 
plotting device. This parameter may be changed during the process 
of drawing the image to define the color value of the "off" pixels 
in a line pattern, or the background color to the rectangle which 
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encloses a character, but if transportability is to be maintained, 
no essential information content should be placed in such a 
dynamically defined background attribute. In either case, the 
action of a screen erase operation is to use the then current 
background intensity to uniformly define the background color 
and/or gray scale. 

Refer to subheading 8.6.2 Gray Scale and Color for the distinction 
between color by index (I<n>) and color by value (I(<color 
specif ier> )) , and for the comments on handling values of <n> that 
exceed the implementation limit. 

The default value for background is device dependent, but it must 
be visually different from the default foreground color. This 
default value takes effect when a valid S(A) is executed. 

8. 7. 1.4. 3 S(T<n>) - Timer 

This option connects timing information to graphical display. The 
numeric value <n> is the number of device dependent timer "ticks" 
for which ReGIS interpretation should be suspended. The intent is 
to allow presentation timing to be done at the end of the 
transmission latency path, in other words, at the device. The 
number of ticks <n> is measured from the time the S(T<n>) is 
interpreted by the device. This is not necessarily the time the 
command is sent or received. Note that S(T<n>) commands may be 
cascaded, as S(T60,T60,T60) , for extended pauses. 

The amount of time represented by each increment of <n> is device 
dependent, but it should be in the tens of milliseconds range. 
For video devices, <n> could most likely be measured in frame 
times. The target increment for timer values should be 20ms +/- 
20% (15-25 ms). Devices must accept and properly execute values 
of <n> as large as 2000. At 60 ticks per second, this allows for 
pauses of up to about 30 seconds. Longer pauses are not expected 
to be used to correct for device latency, but for software timing 
purposes, and must be controlled by host software. 
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8.7.2 WRITING ATTRIBUTES INSTRUCTION 

Raster extensions to the writing attributes instruction allow 
access to a wide range of capabilities of CRT devices, including 
color, gray scale, the simple blink dynamic attribute, image 
memory modification, and area filling. 

8. 7. 2.1 Position Arguments 

There is no significance to the presence of a bracketed position 
argument in the Writing Attributes Extensions for Raster ReGIS. 

8. 7. 2. 2 Numeric Arguments 

There is no significance to the presence of numeric arguments in 
the Writing Attributes Extensions for Raster ReGIS. 

8. 7. 2. 3 Quoted Strings 

There is no significance to the presence of quoted string 
arguments in the Writing Attributes Extensions for Raster ReGIS. 

8. 7. 2. 4 Options 

8.7.2. 4.1 Writing Mode Options 

"Writing modes" are the detailed actions of execution into or onto 
the drawing medium. Some drawing modes are insensitive to the 
presence of previous image contents, others are intimately coupled 
to prior contents. 

8. 7. 2. 4. 1.1 W(C) - Complement Writing 

I When writing, use ones in the pattern register or cell to 
I complement the contents of the pixels present in the image. 

I Ignore zeros in the pattern register or cell; ignore the current 
I foreground and background intensity specifiers. 

8. 7. 2. 4. 1.2 W(E) - Erase Writing 

When writing, ignore the contents of the pattern register, and 
Erase each pixel to the background specifier if W(N0) is in force, 
or write each pixel with the foreground specifier if W(Nl) is in 
force. 


8. 7. 2. 4. 1.3 W(N<0 or 1>) - Negate Writing 

When W(N1) is in effect, the bitwise sense of the linear or area 
pattern is inverted (complemented) during write operations. In 
raster devices which use dot matrices for character cells, the bit 
patterns of these cells are inverted. When W(N0) is in effect, 
the patterns are used normally. The default value, NO, is set 
when a valid S{A) is executed. 


eniDDEiD 


Digital Internal Use Only 



EL-00070-08 31-Mar-1988 Page 8-108 

VSRM - ReGIS GRAPHICS EXTENSION 


8. 7. 2. 4. 1.4 W (R) - Replace Writing 

When writing, replace the current image by input image. Blanks in 
a dashed line pattern or zeros in a pattern cell erase (to the 
background specifier defined by S (I) ) the area overwritten on the 
screen. Ones in the pattern write the foreground specifier. 

8. 7. 2. 4. 1.5 W (V) - overlay Writing 

When writing, overlay ("OR") input onto current image. Blanks in 
a dashed line pattern or zeros in a pattern cell have no effect on 
the area overwritten. Overlay is the intended default writing 
mode in all extended ReGIS implementations, and is set when a 
valid S (A) is executed. 

Four of the writing modes (C = complement, E = erase, R = replace, 
and V = overlay) are mutually exclusive, each overriding all 
others/ the last one specified takes effect. The fifth mode, N = 
negate, may be used in combination with other modes. 

Figure 8-6 shows the effects of each of the writing modes. In 
each case, the solid block was written first, and the patterned 
block was written over it in the indicated mode. 



W(V) W(R) W(C) W(E) 



Figure 8-6: Writing Modes 
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8. 7. 2. 4. 2 Non-Writing Mode Options 

8. 7. 2. 4. 2.1 W (F<integer>) - Foreground mask 

Define the foreground field specifier. The bit encoded integer 
argxoment to F defines a mask which is used to enable all plane 
write and erase operations . ~ Only planes represented by a 1 bit in 
the mask can be written. Ordering of bit assignments and bit 
planes affected is implementation dependent, but the numbering of 
bit planes for purposes of write masking and output mapping 
(S(M...)) must be consistent with each other. The intent of this 
command is solely to limit write access to a sxibset of planes in a 
multiplane device. It does not affect plane readback (S (H) ) or 
those planes which can be moved by screen scrolling (S[]) . The 
default value for this option is "all planes enabled, " and this 
default is set when any valid S (A) is executed. 

8. 7. 2. 4. 2. 2 W(I<n>) or W(I<color specif ier>) - foreground 

Intensity 

Refer to the notes under the Screen command S(I) and subheading 

8.6.2 Gray Scale and Color for details of <n> and <color 
specif ier>. The default value for the foreground specifier is 
device dependent, but must be visible and distinguishable from the 
default value specified for the background by S(I). The default 
value is set whenever a valid S (A) is executed. 

8. 7. 2. 4. 2. 3 W (S<suboption><arguments>) - Shading 

Shading is an area fill operation which is executed in conjunction 
with the Vector and Curve drawing commands . As indicated by 
Figure 8-7, shading is executed to a horizontal reference line. 



shading 

reference” 



Figure 8-7: Selecting a Shading Reference Line 
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Shading is different from both fill and flood. Fill colors in a 
bounded area as it is defined. Flood colors in a bounded area 
after it is drawn, and is not supported in Raster ReGIS. Shading 
colors in a solid or textured area that is not explicitly bounded. 
Shading may be used to execute a fill-like function, but the 
burden of defining and controlling the area so filled is on the 
application using ReGIS. 

A bracketed position specifier defines the location to which 
shading will be executed. In Raster ReGIS, it is possible to 
shade only to a horizontal line, and hence only the Y part of this 
specifier is significant. Open Extensions to ReGIS allow shading 
to a vertical line or to a point, so that either or both parts of 
the specifier may be significant. This mode selection is 
controlled by suboptions to this option. Pixel vector specifiers 
cannot be used as addresses for shading reference definition, as 
the numeric arguments to the S option have a different meaning. 
If this argument is not specified, the current drawing position is 
assumed. 

A numeric argument to the S option is interpreted as a boolean 
switch. A non-zero value causes shading to take on the 
characteristics of the currently specified linear pattern. A zero 
value turns shading off. Shading is, by definition, an area 
operation. Use of a linear pattern to shade in an area requires 
adding a second dimension to the linear pattern. Shading is 
intended to be implemented by drawing lines from each distinct 
point on the drawing path, as described by Vector and Curve 
commands, to the shading reference. It is these lines, not the 
path line, which must take on the shading pattern. Furthermore, 
these shading lines should be registered so that the shading 
pattern is independent of the defining path. Figure 8-7 shows how 
the shading pattern reflects a vertical orientation of the chosen 
line pattern. Note how the vertical line next to the shaded area 
matches the pattern of the shaded area. 

A single quoted character to the S option causes the shading 
pattern to be taken from the two dimensional pattern specified by 
the cell for that character from the alphabet currently selected 
by the A option to the T (text) command. The Text unit cell size 
currently in effect specifies the granularity of the shading 
pattern as it is applied to shading. Any Text option which 
affects the cell unit size is reflected in this granularity. 
These are T(U[]), T(M(]), T(H<n>), and T(S<n>), but not T(S[)). 
T(S[]) is excluded because it sets only the display cell, not the 
unit cell size. The text pattern is referenced to a known point 
in the display so that patterns of adjacent shaded areas match 
where the areas abut. To facilitate the development of patterns 
that match reliably when replicated left to right and top to 
bottom, only the top square part of the storage cell is applied in 
a shading context. Thus crosshatching patterns may be defined 
without consideration being given to the storage cell aspect ratio 
of the characters being used for shading. 
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When shading is enabled, with either a linear or a cellular 
pattern, certain state variables are "snapshot." These variables 
are used with the values they had at the time the shading was 
enabled, regardless of how these values change during the time 
shading remains enabled. 

If shading is re-enabled without being disabled, then a new 
snapshot is taken of the state, and the old snapshot state is 
lost. This allows shading state to be set up and "locked,” while 
the state variables for text are changed to allow interspersed 
execution of shaded drawing and normal text, such as for drawing 
labeled bar graphs. Execution of text is not affected by enabling 
I the shading state. Even if shading is disabled, the snapshot 
I established by its enabling remains in effect for use by polygon 
I fill through the F command. 

The following states are snapshot for use by shading when shading 
is enabled: 

a. Linear pattern, set by W(P<n>) 

b. Linear pattern multiplier, set by W(P(M<n>)) 

c. Text alphabet selection, set by T(A<n>) 

d. Text size, as set by any of T(S<n>), T(H<n>), T(S[]), 

T(U[ ] ) , or T(M[ ] ) 


The following two states are NOT part of the snapshot, and if they 
are changed while shading is enabled, they will be appropriately 
applied in subsequent path-oriented actions: 

1. Writing mode, as set by any of W(E, V, R, C, N, W) 

2. Writing colors, as set by either of W(I) or S(I) 

Shading state is cleared (disabled) on any occurrence of W(S0), 
S(E), or a valid S(A). If shading is enabled as part of a W 
option to a drawing command, then the shading state is cleared 
when the drawing command is terminated by encountering a command 
keyletter at command level, or by synchronization. 
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8.7.3 TEXT INSTRUCTION 

Extensions for graphics text include user definable character 
parameters and user definable alphabets. 

8. 7. 3.1 Position Arguments 

Position arguments to the Text command in Raster ReGIS are treated 
as character escapement values, just as in Base ReGIS. 

8. 7. 3. 2 Numeric Arguments 

Numeric arguments are treated as character oriented pixel vector 
operations in Raster ReGIS, just as in the Base, but differ from 
the Base in regard to the effect of option extensions. In Raster 
ReGIS, a character and character string orientation option is 
present. The direction of the pixel vector operations in Base 
Raster ReGIS is referenced against this string direction, not 
against the absolute horizontal. Hence, Text pixel vector 
direction 0 is parallel to and in the direction of the character 
baseline, direction 2 is perpendicular the base line (and NOT 
affected by the italic angle), direction 1 is forward and up, and 
so on. 

8. 7. 3. 3 Quoted String Arguments 

Just as in the Base, the text arguments to be displayed are passed 
as quoted string arguments, and the four ASCII control codes 
(carriage return, line feed, horizontal tab, and backspace) are 
interpreted by ReGIS when encountered within quoted strings. 

1. Backspace (BS) moves the drawing position one character 

I escapement increment backwards, both horizontally and 

1 vertically. 

2. Line feed (LF) moves the drawing position one character 

I height down, perpendicular to the character baseline; LF 

1 also saves the resulting drawing position for restoration 

I upon occurrence of a subsequent carriage return in the 

I same quoted extent. 

I 3. Carriage return (CR) moves the drawing position back to 

I the position it had at the start of the current quoted 

I extent, or to that saved at the most recent LF, whichever 

1 was more recent. 

4. Horizontal tab (HT) moves the drawing position one 

character increment forward along the baseline. 
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ReGIS text does not automatically scroll or wrap at screen 
borders. The drawing point advances by character escapement 
increments and abides by the addressing constraints outlined in 
the S(A[][]) Screen Address Setup Command description. 

An error character will be displayed for any of the following 
occurrences : 


I 


a. An attempt to print characters from a nonexistent or 
undefined character set (for example, T(A4)'x', where 
alphabet 4 has not yet been defined by an appropriate 
L(A4) command). 

b. An attempt to print characters from outside the defined 
extent of a character set (for example, L(Al,E64) 
followed by T(Al)'a'). 

c. An attempt to print not-yet-def ined characters from 
within the defined extent of a character set. 


The error character may be device dependent, and need not be the 
same for each error above. Solid block characters or checkerboard 
characters are acceptable. The reverse question mark error 
character used in certain text protocols may not be a good choice, 
as the rotations and transformations allowed in graphics text may 
negate the advantages of its otherwise unique shape. 


8. 7. 3. 4 Options 

8.7. 3.4.1 T( A<integer> ) - select Alphabet <integer> 

The default value for <integer> is zero, and this value is 
restored on a valid S(A). 


If a received value of <integer> exceeds the range implemented in 
a device, or <integer> is not specified, then the option is 
ignored and the previous state value is left unchanged. For 
suboptions R and L (described in the ReGIS Base), <n> is 
restricted to have a value of 0. [Note that ReGIS alphabets are 
not now and have never been coupled to ANSI G-set selection; ReGIS 
alphabet numbering is an independent character set enumeration 
scheme.] Should the R or L suboptions be specified without a 
numeric on their A-option, the last set selected by T(A) is still 
selected. If the <n> in the last T(A<n>) was not 0, then the 
suboption is ignored. 


Refer to the description under the Load alphabet command for 
possible device dependent contents of the non-default alphabets. 


mmmr 


Digital Internal Use Only 



EL-00070-08 31-Mar-1988 

VSRM - ReGIS GRAPHICS EXTENSION 


Page 8-114 


8. 7. 3. 4. 2 T(B) - save Text attributes 

Start a temporary text attributes range. The state of all Text 
option settings, including character set selection and the state 
of the in-use character table, but not including temporary writing 
options, are saved on a one-deep text attributes stack, to be 
restored by an E option in the current or a subsequent Text 
commands . 


8. 7. 3. 4. 3 T(D<ang>) - set Text baseline Direction 

Orient the baseline of each character at <ang> degrees to the 
horizontal . 

An acceptable fallback is to limit angular resolution to a device 
dependent value, typically either 45 or 90 degree increments. 
When used in conjunction with the S option, string baseline is 
established. The default value is 0 degrees to the horizontal. 
This value is restored when a valid S(A) is executed. 

8. 7. 3. 4. 4 T(E) - restore saved Text attributes 

Restore text attributes that were in effect when the last previous 
B option was encountered. 

If there was no previous B option specified, the default values 
for all states are restored. Repeated T(E) commands without 

intervening T(B) commands will restore whatever was saved by the 
last T(B), or the defaults if there has been no previous T(B) 
since power up. 

8. 7. 3. 4. 5 T(H<number>) - set Text Height 

I Set the character height to be half of <number> times the 
standard-size-1 cell height, leaving the character width 

unchanged. 

I 

I T(S) changes the entire character display cell size; T(H) changes 
I only the height, the width remaining as set by T(S). The value 
may have a fractional part, but truncation to the next lower 

integer is allowable. Devices must accept values for <number> in 
the range of 1 to 25; conforming software will not use values 

outside of this range. Values larger than 16 should be 
implemented by use of the T(S[]) construct. This state has no 
default value, as the default for T(S) applies. 

8. 7. 3. 4. 6 T(I<ang>) - set Text Italic slant 

Slant subsequent characters by <ang> degrees, referenced from the 
perpendicular to the baseline and measured from the upper left 
corner of the character cell. 
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Positive angles cause the characters to appear to slant backwards. 
A zero <ang> returns the specifier to rectilinear. Resolution of 
italic angle may be device dependent, and angles greater than 45 
degrees (positive or negative) may be taken to be exactly 45 
degrees (positive or negative). The default value for this state 
is 0 degrees (upright); this default is restored when a valid S(A) 
is executed. 

8. 7. 3. 4. 7 T(M( <hint ,vint> ] ) - set Text pixel Multiplier 

Multiply each pixel from the stored character image width by hint, 
and each pixel from the stored character height by vint. 

This is a non-positional use of bracketed extents. Both the 
standard-size-1 unit cell (character image) and the 
standard-size-1 display cell (character image plus intercharacter 
background) are scaled according to these multipliers. If either 
<hint> or <vint> is missing, that value is interpreted as whatever 
value is appropriate for standard size 1. This function provides 
for compatibility with older implementations of ReGIS. The 
preferred mode of character scaling is by use of cell unit size 
and cell display size, T(U) and T(S), respectively. 

8. 7. 3. 4. 8 T( S[ <width,height> ] ) - set Text display cell Size 

Set display cell size in the current screen addressing 
coordinates, but oriented with respect to the value of T(D) in 
effect. 

This is a non-positional use of bracketed extents. The display 
cell is that area of the display affected by the writing of a 
character. It comprises the unit cell (see T(U(]), below) and 
whatever background area is required to achieve the extent defined 
as the display cell. Display cell size must be executed to within 
one physical pixel of the size specified; there is no fallback, as 
is allowed for the scaling of the unit cell. Refer to "further 
notes," below, for more on display and unit cells. If either 
<width> or <height> is missing, the missing values default to the 
values that correspond to the (device dependent) standard size 1, 
as would be set by T(S1). Maximum values of <width> and <height> 
are determined by the arithmetic capacity of the ReGIS device and 
the current imposed coordinate space, that is, 16 bit integer 
arithmetic. Default text display cell size is device dependent, 
and the default is restored on execution of a valid S(A) . 

8. 7. 3. 4. 9 T(S<number>) - set standard Text display cell Size 

Use one of the "standard character sizes". Set the character 
width to be <number> times standard size 1 character width, and 
I the height to be three-quarters of <number> times character height 
standard size 1. This element also sets a device dependent 
character escapement value; this escapement is relative to the 
character direction specified by the D option. "Standard size 
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zero", SO, is implemented as the smallest possible character 
rendering on the device. As for the H option, the argument may be 
fractional, but may be truncated to the next lower integer if the 
implementor chooses. Devices must accept values for <number> in 
the range of 0 to 16; conforming software will not use values 
outside of this range. A value of zero for <number> may have 
special, device dependent meaning. Values larger than 16 should 
be implemented by use of the T(S[]) construct. 

8.7.3.4.10 T(U[ <width,height> ] ) - set Text Unit cell size 

Set unit cell size in the current screen addressing coordinates, 
but oriented with respect to any T(D) in effect. 

This is a non-positional use of bracketed extents. Unit size is 
the size to which the character image is meant to be set. 
Allowable fallback is to scale the unit cell down to the next 
executable size smaller than that specified. If the unit cell 
size specified is bigger in either dimension than the display 
cell, the unit cell is truncated to the borders of the display 
cell. Refer to "further notes," below, for more on display and 
unit cells. If either <width> or <height> is missing, the missing 
values default to the values that correspond to the (device 
dependent) standard size 1, as would be set by T(S1). Maximum 
values of <width> and <height> are determined by the arithmetic 
capacity of the ReGIS device and the current imposed coordinate 
space, that is, 16 bit integer arithmetic. Default text unit cell 
size is device dependent, and the default is restored on execution 
of a valid S(A) . 

8.7.3.4.11 T(W( <suboption> ) ) - temporary Write options 
Set temporary writing controls, as in the Vector command. 

8. 7. 3. 5 Further Notes 

A text "display cell", specified in terms of height and width 
(using screen addressing coordinates) by T(S[]), is the screen 
area to be written for each character. 

A text "unit cell", specified similarly by T(U(,]), is the screen 
area in which the image from character storage is drawn. See 
Figure 8-8. If these two cells are not of identical size, the 
unit cell is upper-left justified in the display cell, with any 
display cell area not filled by the character image explicitly 
filled with the background color. If the unit cell is larger than 
the display cell, only the upper left portion of the character 
image is drawn; that is, the unit cell is clipped to fit in the 
display cell. 
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In the computational limit (that is, where the granularity of 
scaling arithmetic is continuous and not bound by pixel 
increments) , the display cell and the unit cell should map to 
identical sizes. An acceptable fallback for less capable systems- 
restricts Unit cell sizes to integral multiples of the character 
storage cell defined for the character set by Load Pattern 
command, L[r]. A unit size that does not represent such an 
integral multiple may be rounded down to the nearest integral 
multiple value. Implementations may choose to round up if the 
target size is only slightly less than the closest realizable 
size, and if the resulting unit cell would not exceed the display 

cell. The display cell must be executed to within one physical 

pixel of its specified size. 

The L command defines bit patterns; these are invoked by the T 
command and as area shading patterns in the W(S'x') command. 

1 Alphcibet set 0 contains an 8 -bit character in-use set. The 

I content of this set is as deteirmined by the ReGIS Base command 

I T (A(L"*",R"*") ) . All sets except alphabet 0 may be loaded using 
1 the L command. See the description of the Load command for 
further information. 

Different alphabets may be simultaneously available for loading 
and execution. 



Cell Display and Unit Size Cell Display and Dnit Size 

Display size LARGER than unit size Display size SMALLER than unit size 


Figure 8-8: Character Display and Unit Cells 
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8.7.4 REPORT INSTRUCTION 

There is one option to the report command in Raster ReGIS not in 
the ReGIS Base. It reports back the saved names of the loadable 
character sets. 

8. 7. 4.1 R(L) - Report selected Loading alphabet 

Report back the name of the pattern set currently selected for 
loading. The format of the report is (A'<name>') where <name> is 
the name provided in the L(A'<name>') command. 
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8.7.5 LOAD CHARACTER SET INSTRUCTION 

A ReGIS device may implement several alphabets. These alternate 
alphabets are selected for drawing using the "A" option with a 
numeric subargument in the text instruction. The alphabet 
numbered 0 may not be modified, though the defined font is 
implementation dependent. 

ReGIS allows the non-Base alphabets to be loadable. If the Load 
character set command is implemented, then provision for at least 
three loadable alphabets must be made. Loadable alphabets and 
name tables, as defined by L( A<n> "name" ) , may have device 
dependent initial contents, but they must be volatile and subject 
to overwriting. 

The general syntax of a load instruction is the letter "L" 
followed by the ASCII character index, as a quoted character, 
which will be used to refer to the character. This is then 
followed by a sequence of numeric parameters, each individual 
numeric specifying a single row in the character pattern. 

The most significant bit is the leftmost displayed pixel; the 
first parameter is the top row of the character. Parameters are 
hexadecimal integers separated by commas. 

8. 7. 5.1 Position Arguments 

A bracketed coordinate specifier defines the storage size, in bits 
per character, to be used with the selected alphabet. This is a 
non-posi tional use of bracketed extents. The selected alphabet is 
cleared when its storage size is specified. The storage size 
determines how many bits, and how many rows of bits, are encoded 
into the character mask arguments of the Load command. The 
storage size maps to the unit cell size when characters are 
displayed. Negative values are not allowed in storage cell sizes, 
and the default values for storage cell sizes are device 
dependent. 

8. 7. 5. 2 Numeric Arguments 

Each character cell is redefined by a string of bit patterns 
expressed as groups of ASCII hex digits (0... 9, A... Fora 
... f). A cell is terminated by a semicolon or a successive 
parenthesized option specifier or quoted character specifier. 

Note 

The semicolon is required to terminate the Load 
command because of the nonstandard nature of the 
numeric arguments that form the bulk of the Load 
command format. 
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Groups of hex digits, each of which specify the contents of one 
scan line of the character cell, are separated by commas, or by 
exceeding the maximum number of hex digits needed to specify one 
scan line. If, in a given device, the default storage size were 
12 horizontal by 10 vertical, 3 is the maximum number of hex 
digits needed to specify one scan line. A fourth consecutive hex 
digit would be applied to the next scan line whether or not an 
intervening comma were encountered. Where the default storage 
size is not known, storage size should be specified, or commas 
should be used to separate scan line specifiers . 

Cells are always loaded one row at a time using hex-ASCII 
characters. A cell map is specified from the top down, more 
significant bits leftmost in the specifier string. 

a. If more hex digits are specified than are needed for a 
single line of the mask, the extra digits are used on the 
next line. 

b. However, if the width of the character cell is not a 
multiple of four, any unneeded, low order bits of the 
last hex digit applied to that row are discarded, and NOT 
carried over to the next row. Each raster row is begun 
with a new digit. 

c. If too few digits are specified to fill a row, they fill 
the low order portion of the mask, setting the high order 
portion to zero. 

d. If fewer mask lines are specified than exist in a cell, 
the unspecified portion of the cell is cleared to zero. 

e. If more lines are specified than will fit in the storage 
cell, these extra lines are ignored - NOT overflowed into 
the next sequential character. 


Figure 8-9 shows the 
storage cell . 


format of the raster-oriented character 


r 


cell origin 


0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

i' 

1 

1 

1 

1 

1 

0 

1 

0 

0 

0 

0 

0 

0 

0 

1 

0 

0 

0 

0 

0 

[o 

0 

1 

1 

Ti 

Tj 

1 

0 

0 

0 

1 

0 

0 

0 1 

0 

0 

0 

0 

1 

0 

0 

0 

0 

0 

0 

0 

1 ' 

0 

0 

0 

n 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 


0 

0 



0 


-first scan 


-last scan 


high digit 


low digit 


Sample character "F" 

Figure 8-9: Character Storage Cell 


TM 


Digital Internal Use Only 




EL-00070-08 31-Mar-1988 

VSRM - ReGIS GRAPHICS EXTENSION 


Page 8-121 


8. 7. 5. 3 Quoted String Arguments 

A single quoted character serves as the index into the character 
set selected for storage. It will be the same character used for 
recovery of the loaded cell in the Text and Write attributes 
Shading commands. If more than one character is present in a 
string, the first is used, and the rest are discarded. Separate 
character arguments are required to specify multiple mappings. 

8. 7. 5. 4 Options 

8. 7. 5. 4.1 L(A<integer> ) - select Loading Alphabet 

Select alphabet set <integer> for loading. If loadable alphabets 
are provided, at least three must be provided, and they must be 
numbered 1, 2, and 3. Different alphabets may be simultaneously 
selected for access (by T(A)) and loading (by L(A)). L(A) and 
T(A) have no effect on each other. The default character set 
selected for loading is 1, and this default is set when a valid 
S(A) is executed. If a specified value for <integer> exceeds the 
implementation limit, the value is ignored and the alphabet 
selected for loading is the same as the one selected before the 
out of range value was received. 

8. 7. 5. 4. 2 L(A"<name>") - associate <name> with Alphabet 

Associate <name>, which may be up to ten characters long, with the 
character set currently selected for loading. Both <name> and 
<integer> may be specified in the same option, but if <name> is 
specified first, it is associated with the currently selected set, 
not necessarily the one specified by <integer>. 

8. 7. 5. 4. 3 L( E<integer> ) - specify character set Extent 

The <integer> parameter determines the greatest number of 
characters which can be stored as part of the selected alphabet. 
The selected alphabet is cleared when the extent is redefined. 

The range of the extent begins with the space character (code 
value 2/0), and comprises <integer> characters. The ninety-fifth 
character position is code 7/14, the ninety-sixth is 7/15, the 
ninety-seventh is 10/0, the 191st is 15/14, and the 192nd is 
15/15. Codes progress in order between those values. Extents 
greater than 96 represent character values beyond the 7-bit set, 
and these characters must be accessed by 8-bit codes. 

Codes 7/15 and 15/15 might not be encodeable in quoted string 
arguments depending upon the ReGIS user's environment, but devices 
shall make these code positions available. 

The default extent for each loadable alphabet is 96 characters. 
This default is set only at power up. 
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8.8 OPEN EXTENSIONS TO ReGIS 

The following specifies functions of ReGIS which have been used in 
product implementations or are standardized for future 
implementations, but are not required for conformance with any 
particular level of ReGIS. Extensions related to device 
technology not necessarily universal to devices which use that 
technology are described, as well as extensions which are 
potentially useful but not clearly called for on a cost/benefit 
analysis. 

8.8.1 SCREEN INSTRUCTION 

Position arguments to the Screen control command allow the devices 
the dynamic capability of performing screen motion, as in the case 
of text scrolling or "strip chart" generation. The range of 
implementation is very broad, ranging from no implementation at 
all to the full scale "panning" operation of allowing the operator 
to move the viewing window through a much larger image definition. 

There are two models for the scrolling of data in a display: 

a. Coupling the displayed data and display addressing, and 
decoupling both of these from the display. 

A displayed entity has a fixed relationship to the 
address at which it is written. A line drawn from 
location [100,120] to [200,250], for example, will always 
maintain those end points, regardless of how the display 
addresses are moved about the display. This model is 
similar to drawing a picture on graph paper and viewing 
it through a rectangular window that can expose all or 
part of the graph paper behind it. Any new information 
is written on the graph. paper, and the lines on the graph 
paper are used to address the display space. The origin 
is always fixed in relation to the graph paper, but the 
paper can be moved about behind the viewing rectangle, 
modifying the viewer's perception. If the viewing 
rectangle exceeds the boundaries of the graph paper, 
either the opposite edge of the graph paper wraps in, or 
the view is truncated. 

b. Coupling the display addressing and the display, and 
decoupling these from the displayed data. 

The display (the viewing window in the example above) and 
its addressing scheme are coupled. When data move, they 
do so in a manner which moves them from the address at 
which they were executed. 

This follows the addressing scheme of most text 
terminals. As data are entered at the bottom, for 
example, on line 24, old data move up through the address 
space to line 1 and off the top. Line 1 is always at the 
top, and line 24 is always at the bottom. Recovery of 
data moved off the display by scrolling in the opposite 
direction cannot be guaranteed. 
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In summary, the windowing model may extend into a general window 
to viewport model, the scrolling model mimics the use of text 
terminals for display. The appropriateness of either model 
depends upon the goals and capabilities of the underlying 
hardware. Neither model is preferable or prerequisite to the 
other. Neither model is required; devices may elect to not move 
data in their displays at all. 

8. 8. 1.1 Position Arguments 

In the first data movement model above (the windowing model), 
position arguments specify an address in the display address space 
where the origin of the viewing rectangle is to be positioned. 
Data appear to move left as the origin moves to the right, but 
since the data and addresses move together, data are generally 
recoverable by reversing the direction of the movement. 

In the second data movement model above (the scrolling model), 
position arguments specify an address in the display address space 
which will become the new origin. As in the windowing model, data 
appear to move to the left as the origin is moved to the right, 
but in this model the data cannot necessarily be recovered by 
reversing the scrolling, since the data may have been moved off 
and erased from the display medium. 

If data movement is supported in a ReGIS implementation, the 
choice of models used is device dependent. If the hardware can 
support both models, the model in effect is chosen by the S(D) 
option, described below. 

8. 8. 1.2 Numeric Arguments 

Numeric arguments to the Screen control command are treated as 
pixel vector specifiers. They are considered to be equivalent to 
relative address specifiers and are executed as a relative 
bracketed position argument. The data movement model chosen is 
the same for pixel vectors as it is for position specifiers. 

8. 8. 1.3 Quoted String Arguments 

There is no significance to quoted string arguments to the S 
command in Open Extensions to ReGIS. 

8. 8. 1.4 Options 

8. 8. 1.4.1 S(A) - screen Address definition 

The prime function of the screen addressing command in Open 
Extentions to ReGIS is as it is in the Base. The following states 
representing Open Extensions are reset to defaults as a result of 
the execution of the execution of a valid S(A). 
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The equivalent ReGIS command that would institute this setting is 
shown after the defined action. 

a. Blink attribute is set to off. 

Equivalent explicit command: W(A0) 

b. Line width is set to nominal. 

Equivalent explicit command: W(Ll) 

c. Shading state is set to disabled. 

Equivalent explicit command: W(S0) 

d. The clip rectangle is set to the range indicated by S(A), 
and clipping is disabled. 

Equivalent explicit command: S(R[][]0) <[](] as in 

enabling S(A[ ] [ ] ) > 

e. The display offset or scroll state is set to match the 

first coordinate of the S(A[][]) to the upper left hand 

corner of the display. 

f. Data movement control is set to its device dependent 
value . 

Equivalent explicit command: S(Dl), scrolling (if 

supported; else S(D0), windowing) 

g. Cursor visibility is set to ON, and the default cursors 
are selected. 

Equivalent explicit command: S ( C( Hi ) ( II ) 1 ) 

h. Screen scaling is set to 1. 

Equivalent explicit command: S(S1) 

The color output map is NOT AFFECTED by executing an S(A). 

8. 8. 1.4. 2 S(C) - visible Cursor control 

Most interactive devices support a visible cursor that identifies 
either or both of the current drawing position or an input track 
position. The C option to the Screen control command implements 
access to this facility. A numeric subargument to the C option 
enables and disables the visible cursor. S(C1) enables the cursor 
display, S(C0) disables it. The default value for cursor 
visibility is enabled. 


mmw 


Digital Internal Use Only 



EL-00070-08 31-Mar-1988 

VSRM - ReGIS GRAPHICS EXTENSION 


Page 8-125 


Suboptions and subarguments to the S(C) command allow for the 
selection among different cursor representations, and 
simultaneously different cursor representations for output and 
input tracking indicators. 

Cursor Capabilities are Guidelines 

The display actions of cursors should be tailored 
to the device being designed and to its intended 
usage. The mechanisms and actions for cursor 
display described in this section are quite 
complex and potentially expensive to implement. 
While the ReGIS syntax describing the selection 
mechanisms has the force of a standard, the 
display actions of cursors as regards blinking, 
multiple colors, and such may be taken to be 
guidelines, subject to modification as needed for 
product implementations. 


a. Suboption S(C(H<n>)) allows for selection among various 
styles of output cursor. The value of <n> selects among 
predefined cursor styles. A value of zero or one for <n> 
selects a diamond shaped cursor with a small crosshair 
inscribed. This is the default cursor shape, and is 
selected after a valid S(A) has been executed. The 
diamond cursor is normally no more than a half inch or so 
in size. A value of 2 for <n> selects a full screen 
cross hair cursor. This cursor is composed of two lines, 
one horizontal, one vertical, that intersect at the 
drawing position. 

b. Suboption S(C(I<n>)) allows for selection among various 
styles of input cursor. The value of <n> selects among 
predefined cursor styles. A value of zero or 1 for <n> 
selects a the diamond cursor identical to the diamond 
output cursor. This too is the default cursor, and is 
selected after a valid S{A) has been executed. A value 
of 2 for <n> selects a full screen cross hair cursor, 
again identical to the related output cursor. A value of 
,3 for <n> selects a rubber band line, and a value of 4 
selects a rubber band rectangle as the input echo cursor. 
The two rubber band styles are anchored (the first end of 
the line and one corner of the rectangle) at the output 
drawing position in effect at the start of the input 
operation. The other end of the line and the diagonally 
opposite corner of the rectangle track the input 
position . 

c. Additional subarguments to the S(C(I)) and S(C(H)) 
commands allow for program defined cursors. The cursor 
is defined by a pair of characters (a single quoted 
string) and an offset position. The two characters are 


BBagoBD 
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overlaid, with each one being rendered in a different 
color or intensity if color or gray scale is supported. 
If the implementation chooses to blink its cursors, the 
two characters should alternate between the two colors in 
opposite phase. The characters come from the alphabet 
currently selected for drawing by T(A). The offset is 
the distance, in character cell pixels, from the origin 
of the character cell to the point that will be tracked 
for output or input. This distance is always relative to 
the displayed location of the overlaid character pair. 
For example, 

S(C(I[+4,+8)"?»") ) 

defines and selects an input cursor composed of an 

overlaid ? and =, with an offset of four horizontal 
pixels and eight vertical pixels from the corner of the 
overlaid cells to the tracking position. The command 

S(C(H[+0,+0] "OX" ) ) 

defines and selects an output cursor composed of an 

overlaid 0 and X, with the tracking location at the upper 
left hand corner of the character cells. 

d. Applying the offset and quoted string subarguments of the 
S(C(H)) and S(C(I)) forms to the S(C) command directly, 
as by S ( C"XO" [ +4 , +4 ] ) , enables the capabilities as 
described immediately above, but for all possible cursors 
at once. This is an acceptable fallback for devices that 
do not have separate output and input tracking cursors, 
or may be used as a shorthand way of controlling both 
cursors at once. Note that the anchor point for rubber 

band output cursors is not specified by this standard. 

Likely choices might be the screen origin, the screen 
center, or the top point of the current position stack. 


8. 8. 1.4. 3 S(D<integer> ) - data movement control 

For devices supporting both data movement models, the D option 
switches between them. The <integer> argument to D is 0 for 
systems which couple data and addresses, and allows data to be 
recovered by reverse scrolling. This is the windowing model, and 
is most useful in conjunction with the Screen Scaling option, 
S(S), below. An <integer> argument of 1 indicates that the 
scrolling model should be used, where the address space and the 
visible display are coupled, and the data change addresses as they 
move about the screen. If neither model is implemented, the 
option is ignored. If a device supports both modes, the default 
value is 1 (scrolling model); this default is set when a valid 
S(A) is executed. 
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8. 8. 1.4. 4 S(H( <suboptions> ) t ] [ ] ) - retransmit Hard copy 

The hard-copy option retransmits the visible image on the display 
surface to a second display device. This command is primarily for 
dot matrix transfer of images to hard-copy devices, but may also 
be used to store the image on another medium. The format of the 
retransmission, its encoding, or its media are all excluded from 
specification by ReGIS, though Sixels are the implementation 
choice in video terminals and host-based ReGIS systems. The 
hard-copy option may have up to two bracketed position specifier 
arguments which specify two opposite corners of a rectangular 
subset of the screen area. These position specifiers delimit the 
area of the display surface to be retransmitted. If only one 
position specifier is given, the rectangle is defined by that 
position and the current drawing position. If no position 
specifiers are given, the whole visible screen is output. Numeric 
arguments to the H option are NOT interpreted as pixel vector 
specifiers for purposes of specifying an area of the display for 
output. 

A suboption P(,l specifies a starting offset for the graphics 
image when output is re-directed. The value specified refers to 
the offset to be executed on the device to which output is 
redirected. The values specified in the brackets are not 
necessarily those of the imposed coordinate space, but are 
implementation- and retransmission protocol- dependent. The upper 
left corner of the area retransmitted will be offset by the amount 
indicated in the Pi,]. The value set by the suboption remains set 
until changed by the next occurrence of the P suboption, or until 
it is returned to its default by power up or execution of a valid 
S(A) . 

S(H[][]) is a non-positional use of bracketed extents. The value 
specified is always interpreted absolutely, whether signed or not. 
Any missing part of the bracketed extent is interpreted as 0. The 
default value for the state set by (P[,]) suboption is [0,0]. 

There is no standardized way to change the hard-copy offset 
without generating a dump, as the presence of the H option, 
necessary for the interpretation of the (P) suboption, has the 
primary meaning of "execute dump." 

The amount of graphic information retransmitted may, at the 
implementor's option, be limited by the visibility of the image on 
the primary presentation medium. For example, if, in a two plane 
video device, the output map (controlled by S(M)) is set such that 
only the data in one of the two planes is visible on the primary 
output medium, the implementation may choose to only retransmit 
the visible information. In such cases, the method and 
limitations chosen must be clearly outlined in the product 
documentation. 
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8. 8. 1.4. 5 S(M<index>( <color specifier>)) - modify the color Map 

This command modifies the output map for devices with modifiable 
output maps. Value <index> specifies a device index, and <color 
specifier> is the HLS or RGB definition of that entry. The 
suboption alphabet for color specifiers is R, G, B, C, M, Y, W, 
and D for red, green, blue, cyan, magenta, yellow, white, and 
dark, respectively, and HLS for hue, saturation, and lightness. 
The interpretation for <index> is the same as for the indexed 
values to the foreground and background color index specifiers, 
W(I) and S(I). If <index> exceeds the number of entries in the 
selected map, it is mapped into the realized range as are the 
foreground and background indexes. 

Suboption A<n> indicates which map is to be loaded for devices 
which have multiple maps. If A is not present, the primary map is 
used. If A is present without subargument, the primary alternate 
map is used. A color specifier must be complete in one suboption. 
The selected entry will generally be marked for loading when the 
terminating ")" is encountered, but the implementation may batch a 
series of <index>( <color specifier>) sets and load all specified 
entries at once to reduce undesired image "staging" due to 
piecemeal map changes. 

The initial contents of all maps in a device is device dependent, 
but each entry in the map should be visually distinct from every 
other entry (and from the background, if it is mapped separately). 
This applies unless there are more entries than supported colors, 
or unless the number of colors supported approaches or exceeds the 
number visually distinguishable. 

Color maps are set to their defaults only at device power up. 

8.8. 1.4.6 S(R<n>[][]) - define and enable/disable a clip 
Rectangle 

A clip rectangle is a region of the display that can be used to 
limit the area that can be written. The S(R) command in ReGIS 
allows such a rectangle to be defined, and to enable and disable 
the limiting action. 

a. The bracketed extents in the S(R) command define the two 

opposite corners of a rectangle, the sides of which are 
parallel to the ReGIS coordinate axes. These are 

positional specifiers, and may use relative addressing. 
Both corners must be specified. If only one specifier is 
present, the extent of the clip rectangle is not changed. 
If more than two are present, only the last two are used. 

b. The numeric argument to the option is a switch to enable 
and disable clipping action. If <n> is equal to zero, 
then clipping is disabled, and drawing actions can take 
place everywhere in the display. If <n> is greater than 
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zero, drawing actions are limited to the interior of the 
specified clip rectangle. The "interior" of the clip 
rectangle is defined to include what would be drawn as 
the boundary of the clip rectangle. 

c. As an extension, values of <n> less than zero indicate 

that drawing activity is limited to the exterior of the 

clip rectangle. This action is called "shielding." The 
exterior of the clip rectangle includes all the drawing 
area not in the interior (in particular, the boundary is 
NOT part of the exterior). 

d. The extent of the clip rectangle can be set by an 

instance of the command without changing the enabled 

state. For example, the command S(R[ ] [+200,+200] ) sets 
the clip rectangle to an extent 200 square, starting at 
the current drawing position, but it does not affect the 
state of the clipping activity. A subsequent S(R1) will 
enable clipping to this area, or S(R0) will disable 
clipping, without changing the extent. 

e. The clip rectangle maintains its position in the 
coordinate space, even if the display supports scrolling. 
The effect is that the clip rectangle moves with the data 
if the windowing model, S(D0), is supported, and the data 
move through the clip rectangle if the scrolling model, 
S(Dl), is supported. In the latter case, data that move 
out of the clip rectangle never disappear just because of 
movement out of the clipping rectangle. 

f. Screen erase, S(E), always erases the entire display, 
regardless of the clipping state. Erase mode writing, on 
the other hand, is bounded by the clip rectangle if 
clipping (or shielding) is enabled. 

g. The default clip area is the extent defined by the last 
valid S(A) or the entire display surface, if no S(A) has 
yet been encountered. The default clip state is 
disabled, allowing writing to the entire display surface. 
Both defaults are restored by valid S(A) commands. 


8. 8. 1.4. 7 S( S<n> ( <suboptions> ) ) - Scale the visible image 

This option is used for devices which can scale images after they 
are displayed. Taking the model of pixel replication, the 
subargument <n> is treated as a multiplicative scale factor for 
each pixel in the display. When the S(S<n>) form is used, the 
display is scaled isotropically. There are two suboptions (X<n>) 
and (Y<n>) for scaling independently in X and Y. The display can 
be rescaled only by respecifying a scale factor of 1. This option 
is most useful with the windowing data movement model described 
above. The S(S) option causes the display medium (the bit map. 
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for example) to become bigger than the display surface. S(S) and 
S[] then combine to move a small window through a large display 
space . 

Negative values for scaling factors are not allowed. A value 
which exceeds the implementation limit in a device is mapped to 
the implementation limit. The default value for scaling factors 
is 1, and is restored by the execution of a valid S(A). 

8. 8. 1.4. 8 S(W( <suboptions> ) ) - temporary Write options 

This command sets temporary writing controls just as in the Vector 
command. The only useful temporary writing control within the 
Screen command is S(W(M)), which sets the pixel vector multiplier. 
The pixel vector multiplier affects the granularity of the display 
motion generated by S<pixel vector> commands. 
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8.8.2 POSITION INSTRUCTION 

8. 8. 2.1 P(P<n>) - select drawing surface 

Some devices have multiple separate drawing surfaces. Programs 
may select among these separate surfaces with the P option to the 
P command, P(P<n>). The value of <n> identifies the drawing 
surface selected. All drawing surfaces share the same state 
store, that is, current drawing color, selected text alphabet, 
macrograph store, position stack, and so on. 
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8.8.3 WRITING ATTRIBUTES INSTRUCTION 

I There are four options extensions to the Write attributes 
instruction. 

I 8. 8. 3.1 W(A<n>) - Alternate (blink) 

I This option enables the blink (or "alternate") attribute. For 
I values of <n> greater than zero, set the blink attribute on all 
I foreground data drawn until blink is disabled. Application of the 
I blink attribute is disabled by W(A0), S(E), or valid S(A). 

I Clearing the subsequent application of the blink attribute by 
I W(A0) does not change the blinking status of any displayed 
I elements, any more than changing the foreground specifier with 
I W(I) changes the color or intensity of any pre-existing data on 
1 the display. 

I The visible action of blink is implementation dependent. The 
I alternation may be between foreground and background intensities, 

I or between foreground and some other device-dependent setting. 

I Interaction of the blink attribute with Complement and other 
I image-content dependent writing modes is device dependent. Blink 
I frequency and duty cycle are device dependent. 


8. 8. 3. 2 W(L<n>) - Line width control 

This option controls the width or weight of lines and curves. The 
value <n> is a multiplier of the device's nominal line width. 
Nominal line width is device dependent, and is normally the 
device's default line width. W(L2) sets a width twice the nominal 
width, W(l 3) three times, and so on. 

Fractional line widths are allowed. For example, W(L0.5) 
specifies a width 50% less than nominal, and W(L1.5) specifies a 
width 50% greater than nominal. Devices that • do not support 
fractions may truncate to the next lower integer or round to the 
nearest integer, just as they do for other numerics. W(L0) 
selects the minimum imageable line width. 
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8. 8. 3. 3 W( S ( <suboptions> ) ) - Shading 

The Shading option to the W command accepts subarguments 
indicating a shading reference line and shading texture. There 
are also suboptions to the W(S) form which indicate whether 
shading takes place to a horizontal line (the default), a vertical 
line, or to a point. The form W(S(Y)...) indicates that the 

shading takes place to a horizontal reference line; this is the 
default. See Figure 7. The form W(S(X)...) indicates that the 
shading takes place to a vertical reference line. The form 
W(S(P)...) indicates that the shading is to a point. These 
suboptions are volatile, that is, every invocation of shading 
assumes that shading is to a horizontal baseline unless a 

countering (X) or (P) suboption is provided. 

8. 8. 3. 4 W(W) - microcoded Writing modes 

Detailed control of multiplane writing is enabled with the Write 
control option to the W command, W(W) . The option W accepts a 
numeric index and suboptions P<j> and N<k>. The form of the 
instruction extension is W(W<i>(P<j> N<k>)). The values <i>, <j>, 
and <k> are indices for memory contents, typically bit plane 
values. If a pixel to be written has value <i> before the write 

operation, it is written to value <j> if the next value from the 

pattern register, area pattern, or character cell is a 1, or to 
value <k> if the next masking value is a 0. 

These settings override the last specified write mode control 
option (R, C, V, N, or E), but only those entries explicitly 
loaded take effect. Any entries not loaded retain their settings 
as determined by the last effected Writing mode command. 

Any Writing mode command overrides all detailed settings. 

The default writing modes are reset when a valid S(A) is executed. 
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I 8.8.4 TEXT INSTRUCTION 

I 

I [This section became blank as a result of the movement of 
I character support to Base ReGIS.] 


8-bit 


mmr 


Digital Internal Use Only 



EL-00070-08 31-Mar-1988 

VSRM - ReGIS GRAPHICS EXTENSION 


Page 8-135 


8.8.5 REPORT INSTRUCTION 
8. 8. 5.1 R(E) - Report Error 

This command reports back the last error encountered by the ReGIS 
parser. The format of the error report is "n,m", where n is a 
decimal digit string representing the error code, and m is a 
decimal digit string returning supplementary information. Except 
where noted below, this supplementary information is the decimal 
equivalent of the character code of the character flagged as 
causing the error. When it cannot be determined exactly what 
caused the error, 0 is returned in the error character field. 
Only the most recent error code is kept in the error report 
register. The error report register is cleared when ReGIS is 
synchronized by a or by activation synchronization. The error 

report register is not cleared when the report is sent. The 
following are the reportable error codes; 

> 0 » no_error: No error has occurred since the last 
synchronizing operation. The supplementary error field 
returns 0. 

> 1 - ignore_character : An unexpected character was 

encountered and ignored. 

> 2 - extra_option_coordinates : A command option that 

supports paired bracketed extents (such as S(H[][]) or 
S(A[](])) contained more than two coordinate pairs. The 
supplementary error field returns 0. 

> 3 » extra_coordinate_elements : The syntax (,] contained 
more than one comma. Characters after the second comma 
up to the right square bracket (]) were ignored. The 
supplementary error field returns 0. 

> 4 » alphabet_out_of_range ; The syntax L(An) or T(An) 
contained an alphabet number "n" that was less than 0 or 
more than the implementation limit. 


> 5 « alphabet_attribute_error : At least one of the 

following is true; 

a. In the syntax L(An)[h,w] or L(An,Ex), the alphabet 
number "n" was zero. The attributes of the default 
alphabet (alphabet 0) may not be modified. 

b. In the syntax L[h,w], the height "h" exceeded the 
implementation limit. 
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c. In the syntax L[h,w], the width "w" exceeded the 
implementation limit. 

d. In the syntax L(En), the alphabet extent "n" exceeded 
the implementation limit. 


> 6 » reserved code 


> 7 » begin/start overflow; The implementation limit for 

position stack Hepth was exceeded, that is, a V(B), V(S), 
P(B), or P(S) could not be processed because the stack 
was full. 


> 8 “ begin/start_underf low: A V(E) or P(E) was 

encountered without a matching V(B), V(S), P(B), or P(S) 
preceding it. 


8. 8. 5. 2 R(I<n>) - Input processing mode 

This extension selects between separate or overlapped input and 
output processing. R(I0) selects "one-shot" mode. In this mode, 
which is the default mode and is set by executing a valid S(A), 
processing of ReGIS output is suspended by the device while 
interactive input (R(P(I)) is pending. Furthermore, input data 
can be transmitted by the device only once per R(P) or R(P(I)) 
command. 

R(Il) selects "multiple input" mode. In this mode, the device can 
report positions with or without receipt of R(P) or R(P(I)) 
commands. The device reports on operator actions on the input 
devices, typically a mouse or graphics tablet. While in multiple 
input mode, the device can continue to execute output commands as 
received. 

The commands R(I0) or S(A) exit multiple input mode. 

8. 8. 5. 3 R(P(I)) - Report Position Interactive 

This extension differs from the Report Position command in the 
Base ReGIS in that it enables local interaction with an input 
device. This command puts the ReGIS device into input mode. In 
this mode an input device, such as a data tablet, mouse, or cursor 
keys cause an echoing cursor to be shown on the display surface. 
This echo tracks the input device, and generates a position report 
when the user generates a break condition. This break is usually 
effected by enabling an auxiliary control, such as a control 
button, associated with the device. 
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There are three responses allowed to the R(P(I)) command: 

1. The normal bracketed coordinate specifier, just as from 
the normal R(P) command - This is the result from a 
non-interactive device. 

2. An empty report - Only the terminating CR is sent. This 
is in response to a special break condition set by the 
user, indicating that NO INPUT was to be returned. 

3. A normal bracketed response preceded by a break condition 
indicator - This indicator may be a single character code 
or a numeric string. This passes more details of the 
break condition to the application. 


This command is purposely underspecified because of the wide 
variety of input device and input/output device couplings. 
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8.8.6 FLOOD/FILL INSTRUCTION 

The Flood/ Fill command, keyletter "F", specifies general area 
operations in ReGIS. As was the case with Circles and Curves both 
being expressed by a single keyletter. Fill and Flood are really 
different commands in similar guises. Mixing of options intended 
to affect Flood (B) with those intended to affect Fill (P, V, and 
C) is non-conforming usage, and the effects of such mixing are not 
standardized. 

Flood "colors in" a bounded area already present in the bit map 
with variable pattern or texture. Refer to 8.6.4 Area Attributes 
for a discussion of the various area coloring modes. Flooding is 
implemented in devices with read-write display media, such as bit 
map raster displays, since the display medium must be interrogated 
to discern seed values and boundary values. 

Fill defines bounded areas by their edges and colors in only and 
entirely, subject to area texture or pattern in effect, the area 
I (or areas) bounded by the edges presented. Fill is defined in 
I Base ReGIS, and is extended here. Implementations which support 
the F command may elect to support either Flood or Fill or both at 
their option. 

8. 8. 6.1 Position Arguments, Numeric Arguments 

A position specifier to the F command, either a bracketed 
coordinate specifier or a pixel vector digit, specifies the 
location of the "seed" pixel from which a Flood is executed. The 
border of the flooding operation is as determined by the last 
previous F(B()) encountered. If more than one specifier is given, 
each is executed in turn. The current position does not change as 
the result of any flood operations. 

8. 8. 6. 2 Quoted String Arguments 

There is no meaning assigned to the presence of quoted character 
arguments in Fill or Flood commands. 

8.8.6. 3 Options 

8. 8. 6. 3.1 Flood 

8. 8. 6. 3. 1.1 F( B( <suboption> ) ) - flood Boundary condition 

This option sets Boundary conditions for the definition of the 
closed area to be flooded. If the <suboption> is FO, a flood will 
bounded by image areas represented by the background. If it is 
Fl, the flood is bounded by any foreground value different from 
the seed value, or any foreground if the seed location has the 
background attribute. If the <suboption> is I<integer> or 
I ( <color/intensity speo), the flood is bounded by parts of the 
image with the attribute so specified. 
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The default boundary for a flood is as set by F(B(F1)), that is, 
any foreground setting different from the seed value. This 
default is restored upon execution of a valid S(A). 

8. 8. 6. 3. 2 Fill 

I Extended Fill acts as Fill defined in Base ReGIS, with an 

I extension to support complex polygons. 

8. 8. 6. 3. 2.1 F(...F...) - fill complex polygon 

A "complex polygon” is defined as a closed figure described by an 
explicitly disconnected set of edges. Many letterform shapes fall 
into this category. The letter "0," for example, may be described 
as two roughly concentric closed curves defining the outer and 
inner perimeters of the letter shape. The letter "B" may be 
described as two polygons within a third. Because of the interior 
rules for polygons, the letter "i" may be defined as a complex 
polygon with disconnected but nested definitions for the body of 
the i and its dot. See Figure 8-11, below. 

The F option to the F command provides for a one-level deep 
recursion of polygon definition to allow for the description of 
such complex polygons. Further subarguments to the F option are 
the same V, P, and C options described above. The presence of the 
F option decouples the edge streams from one another. This allows 
nested polygons to be defined without the need for an invisible 
edge to connect the edge list definitions. The recursion of the F 
option need only be one deep because of the interior rules for 
polygons. The position of the F option within the F command is 
not critical as regards the ordering of the subpolygons. This is 
because of the interior rules and the deferred execution of 
polygons until the polygon fill terminator is encountered. 

Complex polygons must abide by the same constraints as simple 
polygons as regards the number of entries in the vertex list. The 
total number of vertices is the critical parameter. There need 
not be a separate vertex list for the nested polygons. Multiple 
nested polygons using the F(...F...) option are shown in Figure 
8-11. Note that as the inner loop of the complex polygon is moved 
out of the outer, its interior takes on the interior attribute, 
until, when entirely outside, it becomes a disjoint polygon. 
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Figure 8-10: Simple Polygons 
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Figure 8-11: Complex Polygons 

8 . 8 . 6 . 3 . 3 Common 

8. 8. 6. 3. 3.1 F (W (<suboption>) ) - temporary Write options 
Set temporary write options, as in the other drawing commands. 
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8. 8. 6. 4 Further Notes 

The Flood command uses as a flood pattern the last selected area 
shading pattern as defined by W(S<n>), which selects a pattern 
defined by the linear pattern specifier W(P), or W(S"x")- This is 
true even if shading has been subsequently disabled by W(S0). 
Shading should be disabled before a flood or fill operation is 
initiated. The currently selected write mode and intensity 
specifier are used. These may be changed by the temporary write 
options to the Flood command. 

The boundary conditions for the flood operation may be expressed 
in one of three ways: 

1. As a specific attribute condition. 

2. As any change in attribute with respect to the seed 
location attribute value. 

3. In the single plane system, any change between the 
foreground and the background state. 

The flooded area does not include the boundary. For example, if a 
red (unfilled) circle is on the display, and the current write 
mode is solid green, a flood of the interior of the circle will 
leave a green circle with a red circumference. This allows the 
edge of other objects to be used as a boundary without modifying 
that other object. 

If the area in which the seed location is found is not closed with 
respect to the boundary conditions set, the flood will "leak out", 
causing a writing action that could cover the entire display. 
Note that non-solid vectors written in overlay mode do not 
necessarily form closed boundaries. 

Areas may have complex boundaries, such as the area between two 
concentric circles, or the area between bounded figures on a 
background. 

A boundary need only be connected by diagonally adjacent pixels to 
define closure for Floods. 
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8.9 INSTALLATION ENVIRONMENTS 

This section contains an outline of the requirements for 
environmental support for ReGIS. 

For the purposes of this section, assume that ReGIS addresses two 
environments for the application of the graphics instructions: 

1. Descriptor code enveloped in ANSI escape sequences and 
transmitted on character oriented data paths, or 

2. Use in a bounded graphics system. 


8.9.1 ANSI ENCODING 

The ReGIS command syntax is specified as if it were a seven bit 
encoding. Allowance for an eight bit encoding is an environmental 
issue. For example, ReGIS may be encoded into either the left or 
right half of an eight bit code table, and only character codes of 
the proper sense could be passed to the parser. However, ReGIS 
shall accept eight bit codes within quoted strings for use as 
arguments to text-related or text-indexed commands. 

For communication to devices or interpreters that accept ReGIS as, 
perhaps, one of many device syntaxes, ReGIS commands shall be 
introduced by a DEC-private parameterized form of the ANSI escape 
sequences Device Control String (DCS) and terminated the ANSI 
escape sequence String Terminator (ST). 

For communication to interpreters that accept only ReGIS, such as 
dedicated software for ReGIS translation, or that are capable of 
identifying the data syntax in a file by other means (such as file 
type flagging), ReGIS commands need not be delimited in any way. 

The DEC-private parameterized form of DCS is 

ESC P<n><protocol selector> 

where <n> represents an ANSI X3. 64-like parameter string encoding 
device controls, and the <protocol selector> for ReGIS is lower 
case "p". 

A ReGIS interpreter must recognize two flags encoded in the first 
numeric parameter <n> if one is present in the invocation stream. 
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If the least significant bit of the numeric value is a then 
the interpreter shall force an environmental resynchronization 
before interpreting any following ReGIS instructions. This level 
of resynchronization takes place regardless of the previous state 
of the interpreter, and returns the interpreter to the highest 
command level with no quoted strings or macrograph definitions in 
process. This resynchronizing mechanism shall be implemented in 
all ReGIS interpreters that use DCS/ST delimiting. 

If the second least significant bit of the numeric is '1', the 
interpreter shall process the ReGIS instructions as it otherwise 
would, but should also pass along the source ReGIS stream to a 
text display process for display as text. This simultaneous 
display action is useful for debugging software using ReGIS on 
terminals and other interactive devices. This concurrent display 
action is not mandatory for ReGIS interpreters, and is obviously 
not applicable in all instances. 

ST is encoded as 


ESC \ 

and is the standard terminator for the collection of ANSI escape 
sequence strings. 

All characters within this sequence following the protocol 
selector, up to but not including the string terminator are 
interpreted as ReGIS instructions. Although an entire screen 
image does not have to be included in one invocation of these 
sequences, individual instructions should not be broken up across 
escape sequence boundaries. 

Some implementations may require that leaving ReGIS and 
re-entering via ST and DCS cause the parser to resynchronize, as 
if a semicolon were encountered within the instruction stream or 
as if a resynchronizing parameter were included in the invoking 
DCS. 

Some devices scan for and parse ANSI-mode escape and control 
sequences while interpreting ReGIS. Some of these devices execute 
escape sequences as if the devices were not in ReGIS mode, and 
return to ReGIS mode after such execution. Other devices use the 
occurrence of any escape code, code position 1/11 or 8/* or 9/*, 
as reason to exit the ReGIS mode. Such use may be necessary to 
support non-conforming software, but such use is deprecated by 
this standard. 
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8.9.2 BOUNDED SYSTEMS 

ReGIS is also intended for use in bounded systems even if no 
remote communications link is involved. Therefore, images defined 
in a bounded system may be used in distributed systems and vice 
versa. 

In the realm of such bounded systems, ReGIS should be considered 
for the following purposes: 

a. Graphics text file definition of a graphic image. 

b. Direct use of ReGIS instructions in high level languages 
when no embedded graphics statements are provided. 

c. Communication of a graphics image to a separate graphics 
device . 


It is assumed that such a device should have a ReGIS interface 
"driver" to convert the character strings originating at any of 
these sources to the native graphics hardware instructions of the 
system. 
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8.10 ReGIS COMMAND COMPLEMENT 

The following sections summarize the assigned ReGIS command 
elements. Each section outlines a separate command. 

In ReGIS, a command keyletter can take four forms of argument: 
bracketed extent, numeric, quoted string, and parenthesized 
options . 

Numeric arguments are classified by semantic use, as pixels 
vector, scalar value, boolean, switch, or other use. 

Parenthesized options contain keyletters, each of which can be 
followed by any of the four argument forms. 

Indenting of the construct identifiers indicates its applicability 
and scope, as if in an outline. 

Thus indented under each keyletter will be one or more of [] (for 
bracketed extent), n (for numeric), "" (for quoted string), and () 
(for options and further nesting). Under a () line or subline 
will be the subarguments and suboptions that apply in that option. 

The text on the right describes the capability encoded by the 
construct(s) on the left. Part of this description will be an 
indication of where that construct is defined and what conformance 
level of ReGIS it applies to. The notation {B} indicates the 
construct is part of the ReGIS Base; {R} indicates the construct 
is part of Raster ReGIS, and {0} indicates the construct is part 
of Open extensions to ReGIS. Unless otherwise indicated, all 
constructs have the conformance level of their parent construct. 
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8.10.1 SCREEN INSTRUCTION 


[ ] 
n 

( ) 


[ ] 

n 

tt ft 

( ) 


E 

F 

H 


M 


H 


[ ] 


[ ] 


n 


[ ] 
( ) 


n 
( ) 


n 
( ) 


[ ] 


RGBCYMHLSDW 


RGBCYMHLSDW 


n 

( } 

n 

( ) 


n 


n 


w* 


screen control commands {B} 
screen data movement {0} 
pixel vector, screen data movement {0} 

screen coordinate definition (B) 

coordinate extent (two [] required) (B) 
cursor control {0} 

boolean - cursor enable/disable 
text character used for cursor 

drawing position cursor control 
(as for S(C"") ) 

(as for S(C[ ] ) ) 
input tracking cursor control 
(as for S(C"" ) ) 

(as for S(C( ] ) ) 
data movement mode {0} 

data movement mode selector 
erase display {B} 
feed medium/image complete {B} 
value, frames to advance medium 
image retransmit {0} 

area of display to retransmit (1 or 2) 

destination image offset 

destination image offset vector 
background intensity selector {R} 
value, background index ' 
color/intensity specifier 

(the ReGIS color/intensity alphabet) 
load output color map {0} 

value, output map entry index 

select alternate output map 
value , alternate map id 

(the ReGIS color/intensity alphabet) 
control drawing clip area {0} 

tri-state value: shield, clip, disable 
define clip area (2 needed) 
scale display {0} 
value, scale factor 

scale in X direction 

X direction scale factor 
scale in Y direction 

Y direction scale factor 
suspend interpretation for a time {R} 
value, suspension interval 
temporary write options 


*Temporary write options apply as they would if set by a W 
command level, but only for the duration of the current command 


at 
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8.10.2 POSITION INSTRUCTION 


All Position components are defined in the Base, except as noted. 



B 

E 

P 

S 

W* 


Position instruction 

drawing point destination 

pixel vector, drawing point destination 

position stack push 

position stack pop 

change drawing/display surface {0} 

position stack push 

temporary write options 


*Temporary write options apply as they would if set by a W at 
command level, but only for the duration of the current command. 
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8.10.3 WRITING ATTRIBUTES INSTRUCTION 


W 

( ) 

A 

n 


n 

n 

( ) 

RGBCYMHLSDW 

n 

n 

n 

n 

( ) 

M 

n 


n 

II II 

[ ] 

( ) 

X 

Y 

P 


n 

( ) 

P 

n 

N 

n 


Write attributes instruction {B} 

set writing mode to blinking {0} 
boolean, enable/disable blink 
set writing mode to complement {R} 
set writing mode to erase {R} 
enable foreground planes {R} 
value, foreground mask 
select foreground color/intensity {R} 
value, foreground index 
foreground color/intensity value 

(the ReGIS color/intensity alphabet) 
define line width {0} 
value, line width 
set pixel vector multiplier {B} 
value, pixel vector multiplier 
set writing mode negate {R} 

boolean, negate enable/disable 
select line drawing pattern {B} 

value or bit pattern, selects pattern 

select pattern element multiplier 
value, pattern element multiplier 
set writing mode replace {R} 
set area operation shading {R} 
boolean, enable/disable shading 
select area pattern for shading 
select shading baseline 
modify shading baseline selection {0} 
shade to X 
shade to Y 
shade to point 

select writing mode overlay {R} 
set microcoded writing modes {0} 
before-writing pixel contents 
after-writing pixel contents 
if pattern element is 1 

value of new pixel contents 
if pattern element is 0 

value of new pixel contents 
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8.10.4 VECTOR INSTRUCTION 


All Vector components are defined in the Base. 



n 
( ) 


B 

E 

S 

W* 


Vector instruction 

draw line to end point 

pixel vector, draw line to end point 

position stack push 

draw to position stack top entry, pop 
push empty entry to position stack 
temporary write options 


♦Temporary write options apply as they would if set by a W 
command level, but only for the duration of the current command 


at 
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8.10.5 CURVE INSTRUCTION 


All Curve and Circle components are defined in the Base. 


C 


t ] 
n 
( ) 


A 

B 

C 

E 

S 

w* 


Curve/Circle instruction 
operating point of curve or circle 
pixel vector, operating point 

limit circles to circular arcs 
value, degrees of circular arc 
begin closed curve interpolation 
circumferential circles 
end curve interpolation 
start open curve interpolation 
temporary write options 


♦Temporary write options apply as they would if set by a W 
command level, but only for the duration of the current command 


at 
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8.10.6 TEXT INSTRUCTION 


T 

[ 1 
n 

If tl 
( ) 
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n 
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n II 

R 
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D 
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E 

H 

n 

I 

n 

M 

[ ] 

S 

n 

[ ] 
u 
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w* 


Text Instruction {B} 

set character-to-character escapement {B} 
pixel vector, character position offset {B} 
text to draw {B} 

select character set {B} 

select alternate character set {R} 

select standard character set into GL {B} 
character set identifier 
select standard character set into GR {B} 
character set identifier 
save current text state {R} 
set character/ line baseline direction {R} 
value, angle of baseline direction 
restore saved text state {R} 
set character drawing height {R} 
value, character drawing height 
select character slant {R} 
value, character slant angle 
select character mask pixel multiplier {R} 
pixel mask multiplier 
set character drawing size {R} 

value, character drawing size multiplier 
character display cell size 
set character unit size {R} 
character unit size 
temporary write options 


*Temporary write options apply as they would if 
command level, but only for the duration of the 


set by a W 
current command 
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8.10.7 REPORT INSTRUCTION 


R 


( ) 


E 

L 

I 


n 

M 

( ) 
p 

( ) 


X 

I 


Report instruction {B} 
report error status {0} 

report alphabet selected for loading {R} 
set input mode {0} 
boolean, input mode 
report macrograph contents {B} 

macrograph name 
report drawing position {B} 

report input position {0} 
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8.10.8 FILL/FLOOD INSTRUCTION 


F 


[ ] 
n 
( ) 


Fill instruction {B} / Flood {0} 

flood source position {0} 

pixel vector, flood source position {0} 


B 

( ) 

F 

n 

I 

n 

( ) 

F 

( ) 

PVC** 

w* 


flood boundary condition {0} 

flood to foreground or background 

boolean, foreground/background selector 
flood to index 

value, index of flood boundary condition 
color/intensity of flood boundary 
RGBCYMHLSWD (ReGIS color/intensity alphabet) 
fill complex figure {0} 

(as for normal fill option list) 
specify filling boundary {B} 
temporary writing options 


♦Temporary write options apply as they would if set by a W at 
command level, but only for the duration of the current command. 

♦♦Filling boundary is specified by the same Position, Vector, and 
Curve/Circle formats as would be used to draw the outline alone. 
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8.10.9 LOAD CHARACTER SET INSTRUCTION 


All Load character set components are specified in Raster ReGIS. 


[ ] 
n 

( ) 


Load character cell 

specify character cell size 

numeric (special radix), character cell data 


A select alphabet for loading 

"" associate name reporting name with alphabet 

n value, alphabet to be loaded 

E set size of character set to be loaded 

n value, number of characters 
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Section 

Absolute Location 
definition, 8-12 
Active Position 
definition, 8-12 
Alphabets, 8-119 
Application Free Primitives 
definition, 8-12 
Area Attributes, 8-102 
ASCII Character Set, 8-29, 8-37, 
8-81, 8-119, 8-121 
ASCII Code, 8-22, 8-29, 8-30, 

8-112, 8-119 

Base Logical Device, 8-34, 8-35 
definition, 8-12 
Base ReGIS, 8-23, 8-34, 8-37, 

8-47, 8-58, 8-64, 8-69, 8-74, 
8-87, 8-98, 8-103, 8-112 
Batching Commands, 8-42, 8-128 
Bracketed Pair 
definition, 8-12 


C(A) , 

8-76, 

8-77, 

8-90 

C(B) , 

8-77, 

8-90 


C(C) , 

8-76, 

8-77, 

8-90 

C(E) , 

8-77, 

8-90 


C(S) , 

8-77, 

8-90 


C(W) , 

8-78, 

8-80 



Cartesian Coordinate Grid, 8-33, 
8-59 


Index 

Character Cell, 8-24, 8-82, 8-114 
8-120 

Character Codes 
ReGIS, 8-29 

Character Fonts, 8-38, 8-100 
Circle Constructs, 8-24, 8-74, 
8-76 

Circle Instruction, 8-20 
Closed Curve Sequence 
definition, 8-12 
Color 

HLS, 8-13 

Color by Index, 8-97 
Color by Value, 8-97 
Color Capability, 8-23, 8-35, 
8-69, 8-95, 8-128 
Command Keyletter 
definition, 8-12 
Complement Writing 
definition, 8-12 

Cross Reference, 8-29, 8-34, 8-37 
8-38, 8-39, 8-42, 8-43, 8-46, 
8-52, 8-57, 8-59, 8-64, 8-72, 
8-82, 8-94, 8-103, 8-106, 
8-109, 8-138 
Current Location 
definition, 8-12 
Curve Instruction, 8-20, 8-48, 
8-74, 8-75, 8-80 


Chain 

Encoding, 

8- 

-52, 8- 

67 


change 

ba 

rs, 8-12, 

r 8-13, 

8- 

14, 

8- 

21, 

8-23, 

8 

-29, 8- 

30, 

8-32 

8- 

33, 

8-34, 

8 

-35, 8- 

37, 

8-38 

8- 

39, 

8-41, 

8 

-42, 8- 

44, 

8-45 

8- 

46, 

8-52, 

8 

-53, 8- 

57, 

8-58 

8- 

59, 

8-65, 

8 

-66, 8- 

67, 

8-73 

8- 

75, 

8-78, 

8 

-79, 8- 

81, 

8-83 

8- 

88, 

8-90, 

8 

-92, 8- 

93, 

8-96 

8- 

97, 

8-98, 

8 

-99, 8- 

100 

9 

8- 

103 

, 8-107 

F 

8-111, 

8- 

112, 

8- 

113 

, 8-114 

f 

8-115, 

8- 

116, 

8- 

117 

, 8-120 

r 

8-124, 

8- 

127, 

8- 

128 

, 8-131 

r 

8-132, 

8- 

134, 

8- 

136 

, 8-138 

9 

8-139, 

8- 

143, 

8- 

144 







DEC STD 169, 8-11 
Device Attributes, 8-69 
Dimensional Displays, 8-95 
Display Cell, 8-116 
Display Surface, 8-33, 8-59, 8-81 
definition, 8-12 
Drawing Instructions, 8-55 
Drawing Position, 8-52, 8-75, 
8-77, 8-81, 8-88 
Drawing Primitives, 8-22, 8-74 
Drawing Process, 8-32, 8-36 
Dynamic Attributes, 8-102 

EBCDIC Code, 8-37 
Echo 

definition, 8-12 
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Eight Bit Encoding, 8-43, 8-70, 
8-121, 8-143 

Engineering Change Orders ( ECOs ) , 
8-57 

Erase Writing 

definition, 8-12 
Errors, 8-46, 8-50, 8-51, 8-63, 
8-68, 8-74, 8-88, 8-113 
reporting, 8-135 

Extended Logical Graphics Device, 
8-35, 8-95, 8-100, 8-102 
Extensions to ReGIS, 8-23, 8-31, 
8-37, 8-95, 8-101, 8-102, 
8-103, 8-104, 8-107, 8-118, 
8-119, 8-122, 8-132 

F(B), 8-138 
F(C) , 8-90 
F(F), 8-139 
F(P), 8-90 
F(V), 8-90 
F(W), 8-141 
Figures 

Figure 8-1 , 8-16 
Figure 8-10, 8-140 
Figure 8-11, 8-139, 8-141 
Figure 8-2, 8-54 
Figure 8-3 , 8-60 
Figure 8-4, 8-62 
Figure 8-5, 8-77 
Figure 8-6, 8-108 
Figure 8-7, 8-109, 8-110, 8-133 
Figure 8-8, 8-116, 8-117 
Figure 8-9, 8-120 
Fill, 8-102 

definition, 8-12 
Fill Instruction, 8-138 
Flood 

definition, 8-12 
Flood Instruction, 8-138 
Foreground, 8-35 
Foreign Codes, 8-37 

Graphic Character 
definition, 8-13 
Graphic Text 

definition, 8-13 
Graphics Cursor 
definition, 8-13 
Graphics Devices, 8-23, 8-31 


Graphics Pipeline, 8-22 
definition, 8-13 
Gray Scale, 8-69, 8-95, 8-103, 
8-104, 8-106, 8-107 
definition, 8-13 

Hard-copy Devices, 8-65 
Hard-copy devices, 8-127 
High Level Languages, 8-30, 8-31, 
8-145 
HLS, 8-99 

defaults, 8-100 
definition, 8-13 
Hue, 8-13, 8-99 

Implementation Dependent, 8-32, 
8-35 

Installation Environments, 8-143 
Intensity Attributes, 8-35, 8-81, 
8-96, 8-97, 8-98, 8-103, 

8-109 

L(A), 8-105, 8-113, 8-117, 8-118, 
8-121, 8-135 

L(E), 8-113, 8-121, 8-135 
Landscape Mode 
definition, 8-13 
Lightness, 8-13, 8-99 
Line Pattern 

definition, 8-13 
Line Patterns, 8-71, 8-122 
Load Instruction, 8-21 
Logical Graphic Device 
definition, 8-13 
Logical Graphics Device, 8-32, 
8-33, 8-34, 8-95 

Macrograph 

definition, 8-13 
Macrographs, 8-30, 8-38, 8-39, 
8-49, 8-51, 8-87, 8-88 
Modal Options, 8-48 
Multiplane Displays, 8-35 
Multiplane Writing, 8-133 - 

Natural Image, 8-10 
Numeric Arguments, 8-30, 8-45, 
8-67, 8-82 

Offset 
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definition, 8-13 
Open Curve Sequence 
definition, 8-13 
Open Extensions, 8-122, 8-131, 
8-132, 8-134, 8-135, 8-138 
Overlay Writing 
definition, 8-13 


P(B) , 
8- 

8-65, 

-136 

00 

VD 

00 

8-77, 

00 

VO 

o 

P(E) , 
P(P) , 

8-68, 

8-131 

8-77, 

8-90, 

8-136 

P(S) , 
P(W) , 

8-68, 

8-68 

00 

1 

00 

1 

VD 

O 

8-136 


Picture Element 
definition, 8-14 
Pixel, 8-10, 8-33, 8-34 
definition, 8-14 
Pixel Aspect Ratio, 8-63 
Pixel Image, 8-69 
Pixel Sizes, 8-34, 8-55, 8-70, 

8-95 

Pixel Specifiers, 8-80 
Pixel Vector 

definition, 8-14 
Pixel Vectors, 8-46, 8-52, 8-54, 
8-69, 8-73, 8-75, 8-76, 8-82, 
8-112, 8-123, 8-130 
Plotting Devices, 8-52, 8-95 
Portrait Mode 

definition, 8-14 
Position Address 
definition, 8-14 
Position Arguments, 8-43, 8-52, 
8-55, 8-58, 8-59, 8-69, 8-73, 
8-75, 8-77, 8-87, 8-88, 8-104, 
8-107, 8-110, 8-119, 8-123, 
8-127, 8-138 

Position Instruction, 8-20, 8-67 
Position Stack, 8-55 
Position Value, 8-68 
Protocol 

definition, 8-14 

Quoted Strings, 8-29, 8-38, 8-39, 
8-43, 8-58, 8-68, 8-75, 8-83, 
8-87, 8-107, 8-143 

R(E), 8-135 
R(L), 8-118 


R(M), 8-87 
R(P(I)), 8-136 
R(P), 8-88, 8-137 
Raster Device 

definition, 8-14 
Raster Devices, 8-23, 8-34 
Raster Scan 

definition, 8-14 
Reference Standards, 8-11 
ReGIS 

definition, 8-14 
ReGIS Arguments, 8-21 
ReGIS Philosophy, 8-22 
ReGIS Syntax, 8-29, 8-37 
Relative Location 
definition, 8-14 
Remote Graphics Devices, 8-19 
Replace Writing 
definition, 8-14 
Report Instruction, 8-21, 8-87, 
8-118, 8-135 

Required Extensions, 8-103 
Reset 

definition, 8-14 
RGB, 8-99 
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Saturation, 8-13, 8-99 
Screen Instruction, 8-20, 8-58, 
8-104, 8-122 

Screen Setup Command, 8-36 
Scrolling Data, 8-122 
Seven Bit Encoding, 8-43, 8-121, 
8-143 

Shading, 8-102, 8-109, 8-121, 
8-133 

definition, 8-14 
Sixel 

definition, 8-14 
Sixels, 8-127 
Synthetic Graphics, 8-10 


T(A) , 

8-65, 

8-82, 8 

-83, 8 

-105, 

8 

-111, 8 

-113, 8 

-117, 

8- 

126, 

8 

-135 





T(B) , 

8-105, 

8-114 




T(D), 

8-105, 

8-114, 

8-115 

r 

8-116 

T(E) , 

8-105, 

8-114 




T(H) , 

8-110, 

8-111, 

8-114 



T(I) , 

8-105, 

8-114 
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Text Attributes, 8-100, 8-114 
Text Instruction, 8-21, 8-81, 
8-112, 8-119 

Transportability, 8-22, 8-23, 

8-24, 8-26, 8-31, 8-37, 8-59, 
8-68, 8-100, 8-144, 8-145 
definition, 8-14 


Unit 

Cell, 
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1 INTRODUCTION 

This document defines a method of defining and transmitting encoded bit map data over 
a communication line known as the Sizel protocol. All or portions of this protocol may be 
stored in files. This protocol is to be used in display devices (video and hardcopy) of various 
imagii^ (drawing) capabilities. 

In addition, it defines the relationship of this protocol to the ANSI Text presentation 
protocoL While the Sixel protocol is not intended to be a part of the ANSI text protocol, 
there are certain interdependencies. 

This document regroups several extensions made to the "Sixel Protocol", the original 7-bit 
black and white protocol (LA34ArK100), the 8-bit extension (LA1()0-V2), the variable aspect 
ratio extension (LA100-V2), the color extension (VT240), and finally a limited support for 
software-handled viewporting. 

1.1 OVERVIEW 

The transmission of bit map data is one way of transferring visual information. It is 
required for natural images (pictures usually generated by scanning an original), or as a 
low level protocol for interfacing devices supporting different protocols, or when composition 
time is long compared to transmission time. 

The Sixel protocol allows devices to receive and print black and vdute or color bitmap data 
at various sizes over a stream-oriented communications line. Siz bits of each 7-bit or 8-bit 
character code are tised to represent bit map data, allowing the remaining values to be 
used to control the context of the communications line and to fit within the ANSI text 
S3mtax. 

The areas of interest when considering this protocol are: 

1. Defining the data, at a given quality level, with all attributes. Ensurii^ that an 
imagii^ device having the same capabilities as the generating device will produce an 
identical picture. 

2. Positibnii^ the data 

3. Defatdting mechanisms when some data cannot be exactly reproduced, or some 
command cannot be executed. 

The structure of the protocol is intended to support a layered system approach, where 
there are several independent processes that define or interpret portions of the total data. 
For example, this allows the size of an image to be defined independent of the actual 
image definition. This implied scaling of bit map data is difficult to implement exactly and 
realizations will vary firom device to device. 

The Sixel protocol allows considerable freedom in specifying the value and size of the 
bit data to be displayed. It is eiqpected that most iTnaging devices implementing this 
protocol will not be able to image the bit map data exactly as si>ecifi.ed for all possible 
parameter values. This limitation is usually due to device imagiz^ resolutions, dot sizes 
and computational limitations. The common fallback will be for devices to image at integer 
multiples of the device resolution, but this standard does not prohibit more creative 
solutions. See the section on imaging fallbacks for the definition of proper fallbacks. 
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2 GOALS OF THE SIXEL PROTOCOL 

1. Provide a general purpose image data input for display devices. 

2. Be syntactically compatible with ISO 2022 code definition, and further to be compatible 
with ANSI X3.64 and ISO 6429. This supports the requirement that the protocol 

be transmittable on 7-bit stream-oriented serial lines, including control code (X-ON, 
X-OFF) flow control. 

3. Support screen size images from VT125, VT24X terminals. This size is 768 pixels 
by 240 pixels for the VT125 and 800 pixels by 240 pixels for the VT24X series. Both 
printed at a 2:1 pixel aspect ratio. 

It is a goal that any pixel value combination for rasters of this size be printable by 
conforming devices. In other words, ’picture too complex’ for the above raster sizes is 
not permitted. 

The protocol should support any size rasters, althou^ not all devices will be capable 
of displa 3 di^ them. 

4. It is a goal that it be possible to relate the size and placement of the raster to the 
ANSI text coordinate space, but not that the individual pixels relate to the ANSI text 
coordinate system or characters. It is not a goal to allow modification to the rendition 
of characters imaged via ANSI text with pixels imaged via the Sixel protocol. 

5. It is a goal to allow independmit control over the pixel definitions (shape and value of 
pixels) and the ims^fed size of the pixels. 

6. It is a ^al to be compatible with previous devices supporting limited Sixel printing - 
LA34, LA12, LAIOO, VT125, VT240. 

3 TERMINOLOGY 

Dot - The smallest displa 3 mble unit; a light dot on a screen, an ink dot on the paper. Dots 
can be round, oval, square, rectangular, small or big. 

Pixel - The logical rectangular image area defined by each bit of Sixel data as intended by 
the generation software. The shape of a pixel is defined by an aspect ratio, and has no size. 


Pixel Aspect Ratio - Defines the shape of the pixel as a ratio of the vertical side of the 
rectangle and the horizontal side. For example, a square pixel has an aspect ratio of 1 to 1 
(or 10 to 10) and a pixel twice as high as wide has an aspect ratio of 2 to 1 (or 20 to 10). 

Pixel-Spot - The area that is actually imaged (printed) for each pixeL It has a shape 
(Bound, oval, square..) and a size. The shape and size are totally device dependent, and 
may or may not be related to the grid size. 

Grid • The positions on the display, where pixel-spots may be placed. These positions 
are dimensionless points, even though the pixel spots do have some size which may even 
exceed the grid size. The horizontal distance between the two positions is defined by the 
horizontal grid size parameter. The vertical distance between two positions is defined by 
the horizontal grid size parameter and the aspect ratio parameter. 
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The distance between two positions can be bigger or smaller than the pixel-spot size. This 
relation is totally defined by the device, and may vary fiom device to device, and vary on 
the same device from one set of parameters to another. 

The actual grid sizes available on the device may not match the exact grid size specification. 
In this case, the device will select a grid which best represents the specified grid. This 
Isest fit’ grid is often called the ’actual grid’ or ’actual grid size’. Note that most imaging 
operations deal with the actual grid and not the exact specified grid. 

Grid. Size • The distance between two adjacent grid points. The grid size may be different 
in the horizontal and vertical directions. 

DotffMxel/Pixel-Spot Relationship - An imaging device may use several dots to represent 
a single pixel via a pixel-spot. Multiple dots can be used to cover an area larger than a dot 
size, or to produce some level of darkness, or to obtain some level of scaling. 

Raster - All of the pixels used to define a sizzle image. For purposes of this document, all 
of the pixels defined in a single Sixel control string. 

Raster Size - The resultant size of the raster after it has been printed based on the actual 
grid size. When used in the context of pixels not yet printed, it is just the number of 
horizontal and vertical pixels of the raster. 

Overlap - The percentage of the pixel-spot that is larger than the grid size. Overlap may 
be visually pleasing to smooth certain images, or may be used to cover device registration 
errors, or may be due to the device having a pixel-spot size more limited than the grid size. 


Sixel Akctive Position - The Sixel active position is that position to which the next Sixel is 
to be printed. The actual Sixel is printed with a vertical offset to the Sixd active position 
so that machines which use the baseline of a character for positioning in ANSI text mode 
will be compatible with devices that position based on the ascender he^ht of the character. 
This offset is in the vertical direction, the amozmt of 70 dedpoints (.0972 inch). (See section 
- ANSI Text Interactions, While In Sixel Mode). 

Picture Definition - This is all the data needed to describe the mu^e, including colors, 
size, pixel aspect ratio, and encoded rasters (Sixel Data and Sixel Commands). It does not 
include formatting information such as position or actual presentation size. 

Sixel - A Sixel is a group of 6 vertical pixels represented by 6 bits within a charact^ code. 

Sixel Data - This term includes only the encoded raster portion of the picture definitions. 

Sixel Commands - These are commands included in the picture definition which provide 
additional information beyond the encoded raster, such as color, line breakup, etc. 

4 LEVELS AND EXTENSIONS 

While the Sixel protocol specification allows more device variations than the majority of the 
other SKM specifications, there are still several specific function sets that must be followed 
for compatibility. There are two levels and one extension defined for conforming devices. 
The levels are for variable grid size, while the ^ctension is for color. 
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4.1 LEVEL 1 

Level 1 devices do not support the Set Raster Attribute command, Background Select, 
Horizontal Grid Size or Macro Parameter commands. Lievel 1 devices will parse these 
commands, but only print in one grid size. The level 1 grid size is that defined for Macro 
Parameter 1. 

4.2 LEVEL 2 

Level 2 devices support everything a Level 1 device supports, plus the Set Raster Attribute 
command. Background Select, Horizontal Grid Size and Macro Parameter commands. 

4.3 EXTENSION • COLOR 

Color is an extension to either level 1 or level 2 devices. 

5 SIXEL PRINTING 

Shcel printing consists of setting context and attributes for the phcels and then printing 
each Sixel in received order. 

A Sixel is a group of 6 vertical pixels represented by 6 bits witibin a character code. A one 
value for a bit indicates that a pixel-spot will be placed at the corresponding grid position, 
a zero will cause the corresponding grid position to be unchanged (not written). 

Upon entering Sixel mode, the current Sixel position is determined from the ANSI text 
position and is called the graphic left margin. 

The Sixel active position is advanced to the next horizontal grid position as each Sixel is 
printed. Also, there are a few line control commands that modiJ^ tiie Sixel active position. 
Positioning is alwa 3 r 8 relative to tiie Sixel active position, and can not go backwards except 
for returning to the graphic left margin via the graphic carriage return and next line 
commands. 

The color of a pixel-spot is determined by the currently selected color in the color map, 
as specified with a color specifier control code. The color map is defined by optional 
parameters of the color specifier. Note that all 1 bits of a Shcel are imaged in the selected 
color. Therefore, if the image is to have pixels of different color that fall within a single 
Sixel, only those pixels of the current color should be set to a 1, and the line of Sixel data 
sent again with a new color selector and the appropriate 1 bits set for this color. A line of 
sixels must be sent (with a graphic carriage return between them), for each color that falls 
in the Sixel Une. 

Horizontal and vertical direction foUow the ANSI text horizontal and vertical axes at the 
time Shcel mode was entered, with Sixel drawing always proceeding from left to ri^t, top 
to bottom. 
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6 PROTOCOL STRUCTURE 

The data and commands of the Shcel Graphics protocol can be conceptually separated into 

three primary fields: 

1. Picture Definition • the body of the Shcel protocol which contains all the information 
needed to reproduce the image, regardless of size. The Rcture Definition includes Shsel 
data and Shcel command codes. The Sixel data is the encoded image raster Mdiile the 
Shcel command codes control how the raster will be interpreted. 

The picture definition is used by creation software, editing software, and imaging 
devices. It is int^ded that picture generatii^ software will be able to create a file that 
contains the image definition independent of formatting information. 

2. Formatting information - This data is added to the picture definition by the page 
composition software, defining the size of the picture data. The size is included in the 
Protocol Selector (see the example below) so that the parameters may be added without 
affecting the picture definition data. 

In general, composition software need not interpret the picture definition data, 
althou^ in certain cases it may need to determine the number of pixels in the picture 
definition by looking at the pixel extent parameters. 

3. Positioning data - used by page composition software. The fiorst pixel position is defined 
by the ANSI text active position at the time that the Sixel mode is entered. All other 
pixel positions are relative to the first based on the actual grid size and aspect ratio. 

6.1 SIXEL CONTROL STRING 

Thb formatting and picture definition for a Sixel graphic is contained in a Device Control 

String (DCS) envelope as defined in the "Code Extension" section of this standard, DEC 

STD 070-3. 


DCS Format ‘ting Information Picture Definition ST 

DCS (9/0) is the ANSI Cl control that begins a Device Control Strii^ (may also be coded 
as ESC P (1/11, 5/0) in 7-bits). The Formattii^ Information is represented by one or more 
Device Control String parameters separated by semicolons ";" (3/11) as defined by the 
code extension layer. Thie final character of the DCS Sequence is q (7/1) which identifies 
the Control String as containing Sixel data. The DCS parameters and final character 
together are called the Protocol Selector. The Picture Definition consists of Sixel data and 
commands as described in this standard. ST (9/12) is the ANSI Cl control that terminates 
a Device Control String (may also be coded as ESC \ (1/11, 5/12) in 7-bits). 
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6.1.1 Example Sixel Control String 


ESC P 

\ / 

DCS 


Where: 

Psl 


Ps2 


Pn3 

q 

n 

Pn4 

Pn5 

Pn6 

Pn7 


Psl ; Ps2 ; Pn3 q " Pn4 ; Pn5 ; Pn6 ; Pn7 ESC \ 

\ / \ / \ / \ / 

Protocol Selector Raster Attributes Picture ST 

command data 

\ / \ / 

Formatting Picture Definition 

Information 


Macro Parameter 

Selects from a list of fixed combinations for other 
parameters. Included for backward compatibility. 
New software should always specify this by 0 (zero) . 

Background Select 

0 device default action 

1 no action (don't change zero value pixels) 

2 set zero value pixels to background color 

Horizontal Grid Size 

Given in units specified by ANSI SSU 

(default is decipoints, 1/720 inch) . 

Final Character of DCS Introducer Sequence 

Sixel Control Code for Raster Attributes Command 

Pixel aspect ratio numerator 

(first parameter of Raster Attributes Command) 

Pixel aspect ratio denominator 
Horizontal Extent 

Nxmiber of pixels in image horizontally 
Vertical extent 

Nimber of pixels in image vertically 
(last parameter of Raster Attributes Command) 


7 FORMATING INFORMATION 

The formattmg information currently consists of up to three parameters included in the 
Sixel DCS Introducer Sequence (Sixel Protocol Selector) by the page composition software. 
The following sections define each parameter of formatting information. 

7.1 MACRO PARAMETER 

The first parameter (Macro parameter) selects firom a list of fixed combinations of values 
for other parameters in the Sixel data. This parameter exists for compatibility reasons 
and is to be set to zero in new software. New software is expected to define ^e three 
parameters e^lidtly. Explicit parameter definitions over-ride the macro settix^. The 
following table defines the intent of the macro value: 
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Macro value 

Horizontal 

Pixel Aspect Ratio 


Grid Size 



(X .001”) 

Vert pix : Horz pix 

0 (default) 

7.5 

200 : 100 

1 

7.5 

200 : 100 

2 

3 

450 : 100 

3 

4.5 

300 : 100 

4 

6 

250 : 100 

5 

7.5 

200 : 100 

6 

9 

150 : 100 

7 

10.5 

130 : 100 

8 

12.0 

112 : 100 

9 

13.5 

100 : 100 


The intended vertical grid size implied by the macro value is always 1/72 of an inch. 

7.2 BACKGROUND SELECT 

The second parameter (Background Select) specifies what is to be printed in grid positions 
not eiqtlicitly set to a one in the Sizel data. It is device dependent if the grid positions 
iaclude all possible printable grid positions of the device, or only those grid positions 
within the horizontal and vertical extent parameters of the Set Raster Attribute command. 
Hardcopy devices will process this parameter as no action (as if parameter = 1). 

The possible values for this parameter are: 


0 device default action 

1 no action (no change to zero bit value grid positions) 

2 set to background color * zero bit value grid positions 
are set to the backgrouind color. The background color 
is device dependent. 


7.3 HORIZONTAL GRID SIZE 

The third parameter (Horizontal Grid Size) defines the horizontal grid size in units selected 
by the ANSI text Set Size Unit (SSU) command. This parameter, in conjunction with the 
pixel aspect ratio, defines the grid size. 

If this parameter is zero or not present, the horizontal grid size is given by the macro 
parame^, otherwise, the horizontal grid size parameter overrides the macro parameter. 

If the device does not implement the SSU command, the units will be the default value for 
the SSU command which is Decipoints (1/720 inch). 

8 PICTURE DERNinON 

The Picture Definition consists of Sixel commands and Sixel data which describe a raster 
image. Sixel commands are coded as graphic characters in the range 2/1 to 3/14. Sixel data 
is coded as graphic characters in the range 3/15 to 7/14. 
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8.1 SIXEL COMMANDS 

Sizel commands are used to control how the image raster is interpreted, and may be 
embedded anywhere in the picture definition. 

A Sixel Command consists of a code in the range 2/1 through 3/14 (except parameters and 
parameter separators) which identifies the command, followed by zero or more parameters 
separated by parameter separators. Each parameter is formed by one or more consecutive 
decimal digits 0 throng 9 (3/0 throTigh 3/9). Commands having more than one parameter 
must use the parameter separator ; (3/11) between parameters. A Sixel command is 
terminated by any non parameter code, that is, any code other than 3/0 through 3/9 
(parameter digits 0-9) or 3/11 (parameter separator 0- Note Format Effectors (0/8 to 0/13) 
and SPACE (2/0) are ignored within sixel control strings (see coding section). 

The foUowii^ list summarizes the ciirrently defined Sixel Commands and their coding. 
Sixel Commands that are not recognized by the device must be parsed and ignored. 


Cods 
! ( 2 / 1 ) 

” ( 2 / 2 ) 


# (2/3) 


$ (2/4) 


Coxnmand 

Repeat Introducer 

1st parameter * repeat count 

Set Raster Attributes 

1st parameter * Pixel aspect ratio numerator 
(relative height) 

2nd parameter Pixel aspect ratio denominator 
(relative width) 

3rd parameter -> Horizontal Extent 
4th parameter * Vertical Extent 

Color Introducer 

1st parameter * color number 
(others optional) 

2nd parameter * color coordinate system 

3rd parameter - Hue angle, 0-360 Red, 0-100 

4th parameter - Lightness, 0-100 Green, 0-100 

5th parameter - Saturation, 0-100 Blue, 0-100 

Graphics Carriage Return 


- (2/13) Graphics Next Line 


; (3/11) Parameter Separator 
0 through 9 (3/0 through 3/9) Parameter digits 
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8.1.1 Repeat Introducer 

The Repeat Introducer command allows sixels to be run-length encoded by specifying a 
repeat count before a sizel. The repeat introducer is followed by a numeric value which 
indicates the number of times the next sisel is to be repeated. A repeat count of zero 
implies a repeat count of 1. The ma-giTniiTn value for the repeat count is 32767. If no sizel 
data character follows the repeat count (before the STRING TEIRMINATOR or another 
Sbcel Ckimmand), the repeat count is ignored. The start of another Sizel Command will 
cancel a pending repeat count. 


Format : 

! Pnl <sixel-colaainn-Gode-to-be-repeated> 

2/1 (3/15 - 7/14) 

Where: 

Pnl repeat count 

8.1.2 Set Raster Attributes 

The Set Raster Attributes command defines raster attributes for all of the following data 
within a sizel string, 'nus coiximand must precede any Sizel, or any sizel positioning 
command within a single sizel control string or the command will be ignored. 


Format: 

” Pnl ; Pn2 ; Pn3 ; Pn4 
2/2 

Where: 

Pnl Pixel aspect ratio numerator 
Pn2 Pixel aspect ratio denominator 
Pn3 Horizontal Extent 
Pn4 Vertical Extent 


The first two parameters of the Set Raster Attributes command (Pnl and Pn2) specify the 
Pizel Aspect Ratio. This ratio defines the shape of the pizel needed to reproduce the picture 
without distortion. The ratio is defined by two numbers, a numerator and a denominator, 
and is the ratio of the vertical to the horizontal shape of the pizel. 

For example, if a pizel were to be half as wide as tall, the pixel aspect ratio would be 2:1, or 
200:100. The Pizel Aspect Ratio times the horizontal grid size yields the vertical grid size. 

The third parameter of the Set Rastm* Attributes command (Pn3) specifies the Horizontal 
Extent, the horizontal size in jHzels of the intended image defined by the picture data. 

' This parameter allows trailing background Sizel data to be omitted firom the picture 
definition and still allow for color background, and to provide a summary to avoid a 
complete scanning of the data for the horizontal limits. 

This parameter does not limit the number of pizels a device may image. In the case of 
recmvii^ more pizels than the orient defines, they will be imaged normally. Thus, the 
recmving device will NOT clip the ima^e to the horizontal extent. Conforming software 
will not transmit Sizel data which eztends beyond the specified horizontal extent. 
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The fourth parameter of the Set Raster Attributes comxoand (Pn4) specifies the Vertical 
Extent, the vertical size in pbcels of the intended image defined by the picture data. This 
parameter has the same functionality vertically as the horizontal extent has horizontally. 
The receivii^ device will NOT clip l^e image to the vertical extent. Conforming software 
will not transmit Sixel data which extends be 3 rond the specified vertical detent. 

Conforming software shall specify all parameters explicitly. Guideline: omitted parameters 
for Pnl and Pn2 may be interpreted as ’0’ (zero) and defatilt to ’1’ (one). '';0 may be 
interpreted as ''1;1 for example. 

8.1.3 Color Introducer 

The Color Introducer Command starts a color selection sequence. It is followed by a color 
number and optional additional parameters. The color number always specifies the color 
number with which following Sixel data will be presented. 


Format: 

# Pc ; Pu ; Px ; Py ; Pz 

2/3 \ / 

optional par ame tars 

Whara : 

Pc color nuxnbar 

Pu color coordinata systam 

Px Hua angla, or Rad RGB coordinata 

Py Lightnass, or Graan RGB coordinata 

Pz Saturation, or Blua RGB coordinata 


If a color identifier appears in the data stream vrith no additional parameters, it merely 
selects the color for following Sixel data. If followed by additional parameters, the color 
specifier represents a new definition for the color number. The parameters select a color in 
a uzuversal color coordinate system as follows: 


Pc is tha color nuxnbar, 0 to 255 (or largar davica limit) . 


Pu is tha univarsal coordinata systam: 

0 - illagal 

1 * HLS (hua/ lightnass/ saturation) 

2 - RGB (rad/graan/blua) 


Px, Py, Pz ara 


tha color coordinatas in tha spacifiad systam: 
HLS RGB 


Px 

Hue angle, 0*360. 

Red, 0*100. 

Py 

Lighhness, 0*100. 

Green, 0*100 

Pz 

Sat:i 2 rahion, 0*100. 

Blue, 0*100. 


Values for Pu, Px, Py, and Pz other than those specified above cause the entire color 
specific command to be ignored, indudii^ the color select parameter. Pc. Conformii^ 
software shall specify all paramet^ to be interpreted explicitly. If optional parameters are 
included to define a new color, they should aU be specified. Guideline: omitted parameters 
for Px, Py, and Pz may be interpreted as ’0’ (zero); parameter value ’0’ (zero) for Pu will 
cause the entire command to be ignored. 
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Devices must implement color numbers 0 to 255. Devices may implement color numbers 
larger than 255. Conforming software will use only numbers less than 255, and wiU use 
color numbers in sequence starting from 0. In the case of an indez which exceeds the 
bounds of the device, the unimplemented index must be mapped back into the supported 
range. 

Note this command may load or change the device’s color table. 

8.1.4 Graphics Carriage Return 

The Graphics Carriage Return conunand causes the Sixel active position to move to the 
graphic left margin. This Sixel control code is the only code which allows rewriting of a 
Sixel position and thus is required for writing more than a single color into a Sixel position. 


Format: 

$ 

2/4 

(Graphics Carriage Return does not accept any parameters) 

8.1.5 Graphics Next Une 

The Graphics Next Line conunand catises the Sixel active position to move to the graphic 
left margin and down one row of sixels (six actual grid units). 


Format: 

2/13 

(Graphics Hert Line does not accept any parameters) 


8.2 SIXEL DATA 

Sixel Data is used to represent the pixels of the raster image in columns of six pixels per 
charactm:. 

Sixel data is coded as graphic characters in the raz^e 3/15 to 7/14. The six pixels to image 
are derived by subtracting the ofrset (63 decimal) from the code and assigning each of the 
low order 6 bits to a grid position. The six pixels are arranged vertically as follows: 


Top pixel 


Bottom pixel 


Bit 0 (LSB) 
Bit 1 
Bit 2 
Bit 3 
Bit 4 

Bit 5 (MSB) 
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For example, if the character code 4/1 (ASCII A) is received, the offset value (63 dedxoal) 
is subtracted from the code value (65 decimal). The resultiug value of 2 is mapped into the 
horizontal scan as follows: 

Dat.a Bi'ts: 5 4 3 2 1 0 

2 « 000010 
Scan: (top) 1 o 

2 X 

3 o 

4 o 
,5 o 

(bottom) 6 o 

where "o" indicates the the pixel spot is not printed and V indicates that the pixel spot is 
printed. 

8.2.1 Sixel Column Codes 


Character 

7 

@ 

A 

B 

c 

D 

E 

F 

Octal 

1077 

1001101 

1021 

103 1 

104 

105 

1061 

Decimal 

i 63 

64 1 

65 

661 

671 

68 

69 

701 

Hexadecimal 

1 3F 

401 

41 

421 

431 

44 

45 

461 

Dot Pattern 

1 o 

X 1 

o 

X 1 

o 1 

X 

1 o 

X 1 


1 o 

o 1 

X 

X 1 

O 1 

© 

1 X 

X 1 


i o 

o 1 

o 

o 1 

X 1 

X 

1 X 

X 1 


1 o 

1 O 1 

o 

O 1 

o 1 

o 

! o 

o 1 


1 o 

1 O i 

o 

o 1 

o 1 

o 

! o 

O 1 


i o 

1 O 1 

o 

O 1 

o 1 

o 

1 o 

o 1 


Character 

G 

H 

I 

J 

K 

L 

M 

N 

Octal 

Decimal 

Hexadecimal 

1107 1 
1 711 

1 471 

110 

72 

48 

nil 

73 1 
491 

112 

74 

4A 

113 1 
751 
4B| 

114 1 
761 
4C1 

1151 

771 

4D| 

1161 

781 

4£) 

Dot Pattern 

i o 1 

X 

o 1 

X 

o 1 

X 1 

o i 

X 1 


1 O 1 

o 

X 1 

X 

o 1 

o 1 

X 1 

X 1 


1 O 1 

o 

1 o i 

o 

X 1 

X 1 

X 1 

X 1 


1 X 1 

X 

i X 1 

X 

X 1 

X 1 

X 1 

X 1 


1 o 1 

o 

1 o 1 

o 

i O 1 

o 1 

o 1 

o 1 


1 O 1 

o 

I o 1 

o 

1 O 1 

O 1 

o 1 

o 1 
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Character 

0 

P 

Q 

R S 

T 

U 

V 

Octal 

1117 1 

120 

11211 

122 1 123 1 

124 1 

1251 

1261 

Decimal 

1 791 

80 

I 81i 

821 831 

84 1 

85| 

86i 

Hexadecimal 

1 4F| 

51 

1 511 

521 531 

541 

551 

561 

Dot Pattern 

1 o 1 

X 

1 o 1 

X i o 1 

X 1 

o i 

X 1 


i o 1 

o 

1 I 

X 1 O 1 

o 1 

X i 

X 1 


1 O 1 

o 

I o 1 

O 1 X 1 

X 1 

X 1 

X 1 


1 O 1 

o 

1 o i 

O 1 O 1 

o 1 

o 1 

O 1 


i 1 

X 

1 ^ i 

X 1 X 1 

X I 

X 1 

X 1 


1 o i 

o 

1 o i 

O 1 O 1 

o i 

o 1 

O 1 


Character 

W 

X 

Y 

Z 

[ 

\ 

] 

A 

Octal 

Decimal 

Hexadecimal 

1127 

1 87 

1 57 

130 1 
88 1 
58i 

1311 

891 

59| 

132 1 133 1 134 
90 1 911 921 
5Ai 5B| 5C 

1351 

931 

5D1 

1361 
94 1 
5E1 

Dot Pattern 

i o 

X i 

o 1 

X 1 

o 1 

X 

o 1 

X 1 


1 o 

o 1 

X 1 

X I 

o i 

o 

X 1 

X 1 


1 O 

o i 

o 1 

o I 

X I 

X 

X 1 

X 1 


1 X 

X i 

X i 

X 1 

X i 

X 

X 1 

X 1 


1 X 

X i 

X i 

X 1 

X 1 

X 

X 1 

X 1 


1 O 

o i 

o 1 

o i 

o i 

o 

o 1 

o 1 


Character 

— 

1 

a 

b 

c 

d 

e 

f 

Octal 

1137 11401 

1411 

1421 

1431 

14411451 

146 

Decimal 

1 951 

961 

971 

98 1 

99| 

100 

1011 

102 

Hexadecimal 

I 5F| 

60 1 

611 

621 

631 

64 

651 

66 

Dot Pattern 

1 o 1 

X 1 

o 1 

X 1 

o 1 

X 

o 1 

X 


1 o i 

o 1 

X 1 

X 1 

o 1 

o 

X 1 

X 


1 o 1 

o 1 

o 1 

o 1 

X 1 

X 

X 1 

X 


1 O 1 

o 1 

O 1 

o 1 

o 1 

o 

o 1 

o 


i O i 

o 1 

O 1 

o 1 

O 1 

o 

o 1 

o 


1 X 1 

X 1 

X 1 

X 1 

X 1 

X 

X 1 

X 
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Character , 

9 

h i 

j 

k 

1 

m 

n 

Octal 

1147 1150 11511 

1521 

153 

1154 

1155 

1561 

Decimal 

11031 

104110511061 

107 

1108 

1109 

1101 

Hexadecimal 

1 «7| 

68 i 691 

6A| 

6B 

1 6C 

i 6D 

6E| 

Dot Pattern 

1 o i 

X I o 1 

X i 

o 

i X. 

1 o 

! X 1 


i o I 

o i X 1 

X 1 

o 

i o 

i X 

X j 


1 O i 

o 1 o 1 

o i 

X 

1 X 

I X 

X 1 


1 ^ i 

X i X i 

i 

X 

\ X 

1 X 

X 1 


i O i 

o i o i 

o 1 

o 

1 o 

1 O 

o 1 


1 ^ i 

X 1 X I 

X I 

X 

1 X 

1 X 

X 1 


Character 

o 

P 

q 

r 

3 

t 

u 

V 

Octal 

11571 

1601 

1611 

1621 

16311641 

165 1 

166! 

Decimal 

mil 

1121 

113 1 

114 1 

1151 

11611171 

118 1 

Hexadecimal 

1 6F| 

70 1 

711 

721 

731 

741 

751 

761 

Dot Pattern 

1 o 1 

X 1 

o 1 

X 1 

o 1 

X 1 

o 1 

X j 


1 o 1 

o i 

X 1 

X 1 

o I 

o 1 

X 1 

X 1 


1 o 1 

o i 

o i 

o 1 

X i 

X i 

X i 

X 1 


1 o 1 

o i 

o 1 

o 1 

o 1 

o i 

o i 

o 1 


1 X 1 

X 1 

X i 

X 1 

X I 

X 1 

X 1 

X 1 


1 X j 

X 1 

X 1 

X 1 

X i 

X 1 

X 1 

X 1 


Character 

w 

r 

y 

z 

{ 

1 

} 


Octal 

1167 

1170 

1171 

11721 

173 1 

174 

1175 

11761 

Decimal 

1119 

1120 

1121 

i 122 i 123 i 

124 

1125 

11261 

Hescadecimal 

1 77 

1 78 

1 79 

1 7A| 

7B| 

7C 

1 7D 

1 7E| 

Dot Pattern 

i o 

1 X 

1 o 

i X i 

o i 

X 

i o 

1 X 1 


i o 

i o 

i X 

i X 1 

o i 

o 

i X 

1 X 1 


1 O 

i O 

i o 

1 O i 

X i 

X 

I X 

1 X 1 


i X 

1 X 

( X 

i X i 

X ! 

X 

i X 

1 X 1 


i X 

i X 

i X 

1 X 1 

X i 

X 

i X 

I X 1 


i X 

i X 

1 X 

i X 1 

X 1 

X 

i X 

1 X 1 


9 CODING ISSUES 
9.1 CO CODES 

The indtisioii of CO Controls 0/8 to 0/13 in control string data' is intended for convenience 
in fonnatting and storing control strings. These codes shall have no effect on the 
interpretation of Sixel Control strings. 

Codes in the range 0/0 through 0/7 and 0/14 through 1/15 are considered errors. The 
communications control charact^s, XON (DCl) and XOFF (DCS) are handled at a different 
leveL Cancel (CAN), Substitute (SUB), Escape (ESC), Bell (BEL), and Enquire (ENQ) are 
treated as follows: 
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1. CAN - DCS mode processing, exit Sizel mode. 

2. SUB - process as if a 3/15 code (blank Sizel) was received - this is to limit the affect of 
some communication line errors. 

3. ESC - exit DCS mode processing, exit Sizel mode, begin processing escape sequence. 

4. BEL - same action as in t^ mode. 

5. ENQ - same action as in text mode. 

All other CO (Dodes are ignored. 

9.2 GL CODES 

Codes in the range 2/0 through 7/15 are treated as follows: 


2/0 (SPACE) 
2/1 - 3/14 
3/15 - 7/14 
7/15 (DELETE) 


Ignored 
Sixel Commands 
Sixel Data 
Ignored 


9.3 C1 CODES 

Codes m the range 8/0 throu^ 9/15 exit DCS mode processing, exit Sizel mode, and the 
Cl control code is processed outside of the Sizel mode. 

9.4 QR CODES 

Codes in range 10/0 throu^ 15/15 are errors. The 8th bit is set to zero and the code is 
then processed as a GL code. Conformiz^ software shall not transmit GR codes. 

10 INITIAL STATES 

No Sizel state is preserved from one entering of Sizel mode to the next. All Sizel state is 
reset when the Sizel mode is entered. 

The following states are initialized whai Sizel mode is entered: 


Backgroimd color: 
Sixal color: 

Color nijxnbers: 

Horizontal extent: 

Vertical extent: 


Device default background. 

Contrasting to background. 

All unspecified color numbers image as 
the default Sixel color. 

Distance from current ANSI text position 
to current ANSI right margin. 

Distance from current ANSI text position 
to current ANSI bottom margin. 


Note that the raster attributes (horizontal grid size, pixel aspect ratio) are initialized by 
the Macro Parameter, even if unspecified and defaiilted to zero. 
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Conforming software will alwa 3 rs initialize the horizontal and vertical es^ent. Conformii^ 
software will also initialize any color numbers used in the picture definition. 

11 ANSI TEXT INTERACTIONS 

The Sizel protocol has certain interactions with the ANSI text portion of the device. 
Portions of the ANSI text state affect Sizel printing when Sizel mode is entered, and the 
results of Sizel printing affect portions of the ANSI text state when Sizel mode is exited. 
The majority of interaction is in the area of active position, although margins are also 
mvolve<L 

11.1 ENTERING SIXEL MODE 

The Sizel active position is set equal to the ANSI text active position when Sizel mode 
is entered. The center of the top dot is printed 70 decipoints (.0972 inch) above the 
character baseline for compatibility with devices which use cell positioning. (E^lanatory 
note: 70 decipoints is consistent with the standard spacing of multi-wire print heads.) 
The horizontal and vertical axes are established as the same as the ANSI horizontal and 
vertical axes. No other information is carried firom the ANSI text state; in particular, the 
ANSI SGR (Select Graphic Rendition) selections DO NOT affect sizels. 

11.2 WHILE IN SiXEL MODE 

11.2.1 Printing at The Active Position 

Sizels are printed relative to the active position sudi that the top pixel of the Sizel is 
placed at the current horizontal position and seven actual grid vertical sizes above the 
current vertical position. 

GUIDELINE: 

On devices with s^nificantly higher resolution than the vertical grid size, sizels 
should be processed the same as a font with an above baseline of 70 decipoints, and 
a below baseline of 6*(vertical grid) - 70 decipoints. If the first character flag is set 
whoi pzintij^ sizels, the Active Position will first be moved down by 70 decipoints 
(the above baseline amount). If the Active Position is closer to the Attorn Margin 
than the below baseline value, a wrap condition will occur. Graphic new line will 
act like a LF of 6*(vertieal grid), and wrap at the page mid iiositicm. 

11.2.2 Right Margin 

Sizels defined to be printed past the ri^t margin are not printed. 

11.2.3 Top Margin 

If the Sizel active position is such that printing would occur above the top margin, then 
that part of Sizel will image above the top margin. 
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11.2^ Bottom Margin 

Advancing the Sizel active position past the bottom margin has an effect similar to that 
of ANSI text. In video devices, advancing past the bottom margin will catise scrolling to 
occur (if text drawn into this region would have scrolled). In printers, the action will also 
be similar to that of text causing the active position to advance to the n^ page consistent 
with the setting of Form Mode and other parameters (normal Sixel row vertical spacing 
can be maintained on continuous form machines). 

11.3 EXITING SIXEL MODE 

The Horizontal Active position of the ANSI t^ is not affected by Sixd mode and set 
exactly to what is was when Sixel mode was entered. 

The vertical active position of the ANSI text is affected by Sixel mode. The ANSI text 
vertical position is updated to reflect the vertical motion commands ^ecuted in the Sixel 
printing. Note that on line oriented devices, this may leave the ANSI text active position 
with a non integer line value, only getting back on line boundaries after an absolute 
vertical position command. Also, tiie vertical positioning commands of Sixel mode use the 
ACTUAL grid size, which may be different than the spedfled grid size. Therefore, software 
doing pagination should issue an absolute position command before placing characters to 
insure placement as e2q>ected. 

Some devices may require re-alignment to a grid established for ANSI text after leaving 
Sixel mode. In this case, an adjustment less than one character height may occur in a 
downward direction. Conforming software will not assume any exact alignment of the 
ANSI text vertical position following a Sixel image. 

12 FALLBACK 

As noted in the mtroductioxv, this protocol is quite flexible in the range of imaging formats 
provided. It is recognized that few (if any) devices will be able to faithfully image all of the 
rasters defined by the protocol. The purpose of this section is to specify fallback and best 
fit algorithms and techniques. 

The commands allowing fallback are the interpretation of Pixel aspect ratio. Horizontal 
grid size, and color selecticm. 

A device may require tiiat the grid size used for imaging the raster be different than that 
specified by the Pixel aspect ratio and horizontal grid size. In such a case, the grid size 
used for imagiz^ the raster is called the "actual grid size". Note that several commands 
use this actual grid size specifically, not the ideal grid size spedfled. Conforming devices 
must dearly state in their product documentation how grid sizes fall back. 

The general rule for grid size fall back is that a device selects an actual grid size that will 
come dosest to but does not exceed the specified grid size, but never less than the smallest 
imageable imit of the device. (That is, if the smallest size that a device can print is larger 
than the spedfled grid size, the device prints it anyway, using the smallest iinit as the 
actual grid). 
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Since some devices may have high frequency grid size errors that do not accumiilate, 
the average grid size over not more than 30 pixels is used to determine the actual grid 
size. Th^e non-accumulative errors may be due to devices medianics (two different 
resolution mechanism working together like a print head and a paper motor), or due to 
implemeutation of a scaling algorithm that combines a non-integer number of pixels into 
an integer number of device print units. 

The pixel aspect ratio should be preserved if possible. 

GUIDELINE: 

Many ctnmnon grid size specifications were intended for devices with coordinate 
units based on 1/72" (equal to 1 point or 10 decipoints). When converting to 
150/300/600 dpi devices, the proper fallback is to use 1/75" for each decipoint 
instead of 1/72”. This results in a slightly smaller image (4%), but avoids pixel 
interference pattens teom attemptiz^: to scale to a non int^ral number of device 
pixels. 

There are two classes of color fallback - black and vdiite (monochrome), and limited true 
color. 

For monochrome devices, there are several levels of fallback that are device dependent. 
The most common and the least that conforming devices must do is to write all the one bits 
in the only color available and not write the 0 bits. Another fallback woiild be to texture or 
halftone each pixel, or even texture or halftone an area of pixels. 

For color devices that can not image aU the colors possible, mapping of the color definitions 
to the device set is acceptable. The following eight-color mappii^ shall be used for eight 
color devices using a subtractive color process. 


HLS Coordinate System 


Hue Angle 

Intended HLS 

Color Fallback Color 


31 - 90 

Magenta 

Magenta 


91 - 150 

Red 

Red (Yellow + Magenta) 

151 - 210 

Yellow 

Yellow 


211 - 270 

Green 

Green (Yellow + 

Cyan) 

271 - 330 

Cyan 

Cyan 


331 - 30 

Blue 

Blue (Magenta 

Cyan) 

Lightness 

0% - 14% 

Disregard hue 

angle, print black 


15% - 85% 

Print based on hue angle 


86% - 100% 

Disable Printing (White) 



Saturation is ignored, assumed to be 100% 
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RGB Coordinate System 


Red 

Green 

Blue 

Intended 

Color 

Fallback Colors 

0 

0 

0 

Black 

Black (Yellow+Magenta+Cyan) 

1-100 

0 

0 

Red 

Red (Yellow H- Magenta) 

0 

1-100 

0 

Green 

Green (Yellow + Cyan) 

1-100 

1-100 

0 

Yellow 

Yellow 

0 

0 

1-100 

Blue 

Blue (Magenta + Cyan) 

1-100 

0 

1-100 

Magenta 

Magenta 

0 

1-100 

1-100 

Cyan 

Cyan 

1-100 

1-100 

1-100 

White 

(None) 

0 

» selected 

color is 

not used 


1-100 

» selected 

color is 

used 



12.1 DEVIATIONS 

12.1.1 VT125 

1. iBitialization - The 'VT125 does not reset the Sizel writing color to contrast to the 
background. 

2. Relation to ANSI tezt position - The VTl^S does not start the Sizel position at the 
ANSI tezt position but rather at the upper left comer of the display. It does not update 
the ANSI tezt vertical position at the termination of a Sizel image. 

3. Color numbers - The ^125 accepts color numbers 0, 1, 2, 3 but does not allow color 
specifiers. 

4. Background select - The VT125 does not accept this parameter. It always uses the 
background color for unwritten sizels by erasing the screen to background (Le. eztent 
is the entire screen). 

5. Scrolling - The VTI^S does not scroll when the bottom margin is reached. 

6. Raster attributes - The only raster attributes accepted by the VT125 is defined by 
Macro Parameter value of 1. Thus all other combinations of raster attributes fall back 
to this selection. 

12.1.2 VT240 

1. Initialization - The 'VT240 does not reset the Sizel writing color to contrast to the 
background. It retains the colors from the previous Sizel transmission. 

2. Relation to ANSI tezt position - The VT240 does not start the Sizel position at the 
ANSI tezt position but rather at the upper left comer of the display. It does not update 
the ANSI tezt vertical position at the termination of a Sizel image. 

3. Horizontal and Vertical Eztent - The VT240 assumes that the eztent of the image is 
the entire screen when Background Select is specified to fill in the background; thus 
the 'VT240 erases the screen to background in this case. 

4. Scrolling - The VT240 does not scroll whm the bottom margin is reached. 
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5. Raster attributes - Tbe only raster attributes accepted by the VT240 is defined by 
Macro Parameter value of 1. Thus all other combinations of raster attributes fall back 
to this selection. 

6. Horizontal Grid Size parameter - The VT240 interprets this parameter as a different 
function. The effect of specifying this parameter has very limited effects. 

12.1.3 LA50 

1. The LA50 has a hardware switch to select between 2:1 and 2.5:1 pixel aspect ratios. 
2:1 is required for Level 1 conformance. 

12.1.4 LA100 and LA210 

1. The LAIOO and LA210 are Level 2 devices (recognize the Macro Parameter), but do not 
recognize the set raster attributes command. 

Guideline: Software that wishes to support these devices e3q>licitly may set the Macro 
parameter for the desired characteristics, but should also specify the horizontal grid 
size (Pn3) and raster attributes to over-ride the Macro parameter for use on other 
Level 2 devices. 

12.2 CHANGE HISTORY 
12.2.1 Revision AX11 to AX12 
General 

1. Removed Revision AXll change bars. Added change bars to any change that could 
affect conformance or interpretation of the document or should be brought to the 
attention of terminal implementors or software engineers. 

2. Re-organized main body of the standard to combine S 3 mtax and semantic information, 
making it easier for implementors to follow. 

Tommology Section 

3. Removed definition of 'Rast^ Aspect Ratio” since the term is not used an 3 nvh«re in the 
chapter. 

4. Clarified "Picture Definition" by indicating it consists of Sixel Data and Sixel 
Commands. 

5. Added definition of Grid Size; the distance between two adjacent grid points. 

6. Added definition of SIXEL. 

Macro Parameter 

7. Added sentence: The intended vertical grid size imphed by the macro value is alwa 3 rs 
1/72 of an inch. 

8. Chai^;ed the pixel aspect ratio for macro value 5 from 183:100 to 200:100. Macro value 
5 is intended to give a 200:100 pixel aspect ratio (as on the LN03). 183:100 is the 
fallback on the LA12/34/100/210. 

Sixel Commands 

9. Added format descriptions to each Sixel command. 
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10. Clarified meaning of "ignoring" unrecognized sizel commands to indicate command and 
parameters must be parsed and ^ored. 

11. Clarified bdiavior of Repeat Introducer when shcel colimm code does not follow 
immediately. Starting another sizel command wiU cancel a pending repeat count. 

12. Added material on Set Raster Attributes Command: 

"Conforming software shall specify all parameters ezplicitly. Guideline: omitted 
parameters for Pnl and Pn2 may be interpreted as ’0’ (zero) and default to ’1’ (one)." 

Clarified that the Set Raster Attributes command must precede any sizel, or any sizel 
positioning command within a single sizel string or the command wiU be ignored. 

13. Added material on Color Introducer command: 

"Conforming software shall specify all parameters to be interpreted ezplicitly. If 
optional parameters are included to define a new color, they should all be specified. 
Giiideline: omitted parameters for Pz, Py, and Pz may be interpreted as ’0’ (zero); 
parameter value ’0* (zero) for Pu will cause the entire command to be ignored. 

"In the case of an indez which ezceeds the bounds of the device, the unimplemented 
indez must be mapped back into the supported range." 

"Note this command may load or change a device’s color table." 

ANSI T^d; Interactions 

14. Clarified that the ANSI tract active position is not changed when Sizel mode is 
entered. The center of the top dot is printed 70 dedpoints above the active position. 
(Ezplanatory note: 70 dedpoints is consistent with the standard spacing of multi-wire 
print heads.) 

15. Added guideline on printing at the active position for devices with significantly higher 
resolution than the vertical grid size. 

16. Simplified section on Bottom Margin by emphasizing that sizels should be treated the 
same as tezt, and removing duplicate material from the PSRM positionii^ controls 
chapter. 

Other 

17. Added an racample d a complete Sizel Control String. 

18. Corrected list item numbers (1-3) whidi were confused with Background Select 
parameter values (0-2). 

19. Removed SPACE (2/0) from the set of sizel control codes. Added statement SPACE 
shall be ignored in sizel control strings. 

20. Added paragraph stating that format effectors (0/8 - 0/13) shall not effect the 
interpretation of sizel control strings. 

21. Added paragraph to Coding section describing how GL codes are handled to make it 
inclusive of all 8-bit codes. SPACE (2/0) and DELETE (7/15) shall be ignored. 

22. Added statement that: Conforming software shall not transmit GR codes. 

23. Added table of Shcel column codes. 

24. Clarified software conformance requirement for initialization. Conforming software 
will always initialize the horizontal and vertical eztent (not just if used in the picture 
definition as stated for color numbers). 
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25. Added statement to fallback section that: Conformii^ devices must clearly state in 
their product dociunentation how grid sizes fall back. 

26. Added guideline on fallback for 150/300/600 dpi devices. 

27. Fixed legend on RGB fallback table to indicate ’0’ means selected color is NOT used. 

28. Added LA50 to deviations section. 

29. Added LAIOO and LA210 to deviations section. Included guideline on use of the Maoro 
parameter. 
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1 INTRODUCTION 

Dynamically Redefinable Character Sets (DRCS) are an extension to levels 2, 3 and 4 of 
the Character Cell service class and levels 1 and 2 of the Hardcopy Display service class. 
They provide the capability of loadix^ into the terminal a font description which can be 
designated and invoked as a resident character set. The font loadii^ format as defined for 
DRCS is flexible enou|^ to be applicable to a wide variety of devices, includii^ display and 
printing devices of various resolutions, and var3nng amounts of font storage capability. 

In this document (DEC STD 070-10), the term "font file" refers to a sequence of bit patterns 
that define the graphic ssmibols of a coded character set. 

1.1 VIDEO CHARACTER CELL DISPLAY REQUIREMENTS 

In Level 2 only one 94-character font buffer is required for conformance. Because Level 2 
is a Character Cell Display, the font files which can be loaded are fixed width only. A 94- 
or 96-character font buffer is required for conformance in Level 2 if the device supports 
a 96-charaeter graphic set designation. The 96-<^aracter graphic set designation is part 
of the 8-bit Interface Architecture Extension. In Level 3 and 4, only one character font 
buffer is required to support either a 94- or 96-character set for conformance; support of 
96-character graphic sets is required in Level 3 or hi^er. Refer to DEC STD 070-3 Code 
Extension Layer for more information. 

For Level 2, 3 or 4 conforming devices, the minimum number of logical pixels per character 
in the DRCS font buffer is 80, defining a character cell matrix 8 wide by 10 hig^. This does 
not include inter-character space for text characters, which is provided automatically when 
text format is specified. 

1.2 HARDCOPY CHARACTER CELL DISPLAY REQUIREMENTS 

For devices which conform to Level 1 or 2 of the Hardcopy Display service class, a minimum 
of three character font buffers is required, each supporting either a 94- or 96-character 
graphic character set; support of 96-character graphic character sets is required in all 
levels of the Hardcopy Display service class. The number of logical pixels per character is 
device-dependent but shall support at least the resolution of the drafi;-quality resident font 
files. Hardcopy DRCS fonts may use the whole character cell, including inter-character 
space. 

2 TERMINOLOGY 

CdU Matrix Size - The width and height in logical pixels of a character cell. 

Character Cell - A rectangular bit pattern which defines the foregroimd and background 
values of a single character rendition. 

Coded Character Set - A set of named charact^s and th^ one-to-one relationship with 
bit combinations. 

Control String - A class of control fiinctions (bit strings) introduced by a special 
bit combination and terminated by a string terminator, the interpretation of which is 
dependent on the introductory character sequence. 
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DCS Introducer Sequence - The sequence of characters in a Device Control String 
which immediately follows the DCS control code and precedes the command shring. Within 
Digital, DCS Inriroducer Sequences have the same format and follow the same parsing 
rules as control sequences. 

Designate - To identify a set of characters that are to be represented, in some cases 
immediately and in others on the further occurrence of a control hmction, in a prescribed 
maimer. 

Font - An instance of a type family having a specific type size, style, characteristic weight, 
and character proportion. 

Font File - A sequence of bit patterns or picture descriptors which define the graphic 
symbols of a coded charactm: set. 

Escape Sequence - A bit string tiiat is for control purposes in code extension procedures 
consistii^ of two or more bit combinations, the first of which is an Escape (ESC) character. 

Invoke - To cause a designated set of characters to be the prescribed bit combinations 
whenever those bit combinations occur, until an appropriate code extension function occurs. 

Logical Pixel - A single element of a binary image, which may (but does not necessarily) 
map to a physical pixel in either the transmitting or receiving device. 

Scan - One pass across an image in either the encodil^: or decoding process, consisting of 
the height of one sixel, or six pixels. 

Set Size - A value which defines the relationship of a font definition to physical display 
parameters. 

Sixel - A 7-bit or 8-bit diaracter, the lower six bits of which represent binary image data. 

3 FUNCTIONAL DESCRIPTION 

3.1 LOADING FONT FILES 

The DRCS font buffers may be down-line loaded on command from the host, using the 
Down-Lone Load (DECDLD) control string. The DECDLD command string consists of a 
sequence of binary data in sixel format which defines the composition of the font file. 

3.2 ASSOCIATING FONT FILES WITH CHARACTER SETS 

The command string also contains parameters which specify the association between a 
character set designation string and the font file to be loaded into a buffer. The downloaded 
font file may be identified as replacing one of the character sets biiilt into the device (for 
example, ASCII) or as a new character set not present in the device. Refer to DEC STD 
070-3 Code E^Oension Layer and DEC STD 070-5 Character Cell Display. 

When the character set designation string of a loaded font file which replaces a built-in 
character set is changed, either to another built-in set, or to a new character set, the 
built-in set that was replaced must be made available in the device without additional 
interchange. 

It is recommended for new devices that when a loaded font file which replaces a built-in 
character set is completely erased by an application, via the Pe parameter, that the device 
make the original built-in set available without additional interchange (not mandatory). 
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3.3 DESIGNATING AND INVOKING CHARACTER SETS 

Once a font haa been loaded its associated character set, whether DRCS or otherwise, may 
be designated to any of the four G-sets (GO, Gl, G2, or G3), and may invoked into either 
the left or ri^t hand sides (GL or GR) of the In Use Table, according to the restrictions of 
ANSI code extension. 


NOTE 

g^eharaeter fonts may not be directly designated into GO. Refer to the "Code 
Extension Layer" section. 

In oth^ words, it may be used in any manner that standard character sets are used 
including, if applicable, as the User Preference Set. 

3.4 NOTE ON FUTURE USE OF FONTS 

It should be noted that the font file loading mechanism as defined in this specification for 
DRCS character sets may have broader application in the future, when fonts are used 
widely as a means of modifying the graphic rendition of a particular coded character set. 
In this case, the font numbw parameter included in the DECDLD load sequence will be 
used as a font identifier which may subsequently be assigned to a rendition value and 
selected using the Select Graphic ^ndition (SGR) control function. The assignment may 
be accomplished using the Font Selection (FNT) control as defined in ANSI X3.64-1979 
(p.37). 

3.5 CELL MATRIX SIZE, SET SIZE, AND FONT USAGE 

There are four parameters which affect the relationship between a font file definition as 
loaded into the font buffer memoiy and its physical appearance on the display. These 
parameters are: 

1. Character Cell Matrix Size 

2. Font Set Size 

3. Font Usage 

For any given font file, there are two possible Font Usage values. Text and Full Cell. 
For any given Font Usage, there are appropriate Character Cell Matrix Sizes which are 
fypically device dependent. Furthermore, each Character Cell Matrix Size in a pcuticular 
device may be limited to rendition in certain Set Sizes (80- or 132-column widths, for 
example). 
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The following diagram describes this relationship: 


FONT FILE DEFINITION 


TEXT FULL CELL 

. / I \ / I \ 

CELL MATRIX SIZES CELL MATRIX SIZES 

/ 1 \ / 1 \ 


SET SIZES SET SIZES 

Because of the device dependent nature of these interactions, the product literature must 
be consulted for each device to determine the appropriate combination of parameters for a 
particular application. 
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4 CONTROL FUNCTIONS 

DOWN UNE LOAD (FONT RLE) DECDLD 


Levels: 

2X, 3X, 4X Video Charaotex Call 
IX, 2X Hardcopy Display 

Purpose: Down-line load font file patterns. 


Format: The DECDLD control is a Device Control String consisting of an introducer 
sequence, followed by a command string. The format of the introducer sequence is: 

DCS Pfn ; Pen ; Pa ; Pcmw ; Pss ; Pu ; Pcxnh ; Pcss { 

9/0 Paramatar String ... 7/11 

The introducer sequence is terminated by the final character { 

(7/11). 

The command string format is: 

Dscs Sxbpl ; Sxbp2 ; • • • ; Sxbpn ST 

The command stris^ is terminated by the Sting Terminator character 9/12 (in 7-bits, ESC 
\, or 1/11 5/12). Refer to DEC STD 070-3 for a complete descripton of the Device Control 
String format. 


Description: 

The DECDLD control string down-line loads one or more characters of a specified 
94-character or 96-character (if required) D 3 mamically Redefinable Character Set (DRCS) 
with a specified logical pixel pattern. 

On video terminals, the affected characters in the DRCS set may also change the 
presentation of characters from this set ciurrently being displayed on the screen. The 
DECDLD control does not clear the screen. 

In printers, DECDLD will not affect the presentation of characters already on the page. 
Notes: 

1. Only character positions 2/1 through 7/14 may be loaded in 94-character sets. 

2. (Character positions firom 2/0 through 7/15 may be loaded in 96-character sets. 

3. Character cell sizes are given in l<^cal pixels, width by height. 

4. Loaded character sets are not required to be loaded into non-volatile memory. 
Therefore, if the terminal is powered down all loaded sets may be lost. 

5. The host cazmot read back loaded character sets. 

6. The fonts loaded by the DECDLD command are separate and distinct fi*om the ReGIS 
graphics "Load Pattern Cell" command. The ReGIS cheu'acter sets may not be used 
except with ReGIS "text" commands. 
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7. A Soft Reset function (DECSTR) does not erase font files loaded by t^e DECDLD 
command (although the designation of character sets associated with those font files 
may change). 

8. The soft character set may be cleared using any of four techniques: (1) Using the 
DECDLD function firom the host; (2) By restilt of a power up test sequence; (3) From 
Setup - the RECALL or DEFAULT functions, (but not RESET TERMINAL); (4) On 
video terminals via the RIS sequence, ESC c, (but not DECSTR). 

9. On video terminals, DECSCL performs a soft reset to put the terminal in a known 
presentation state without affecting data already displayed (does not clear DRCS). In 
printers, DECSCL is interpreted as "reset to base state" and will clear any DRCS. 


4.1 INTRODUCER SEQUENCE FORMAT 

The followii^ selective parameters control the operation of the font load function. All 
parameters have the same syntax as a control sequence and may be omitted, in which case 
the default values are used. - 

4.1 .t Parameter (Pfn): Font Number 

The font number parameter, Pfn, specifies the particular DRCS font buffer to be loaded, 
startix^ with btiffer 1. 

On video terminals, only one font buffer is required for conforming products implementing 
the DRCS extension. An omitted parameter, or a parameter value of zero, will default to 
the first empty font buffer, or, if none are empty, to font buffer 1. 

On printers, three font buffers are required. An omitted parameter, or a parameter value 
of zero, will default to font buffer 1. 

Attempts to load font buffers greater than the required number will produce results which 
are UNDEFINED by the architecture. Therefore, conforming software will not specify font 
numbers greater than the number of font buffers required. Hardware will ignore attempts 
to load font buffers greater than the number implemented. 

4.1 JZ Parameter (Pen): First Character In Set To Load 

The second parameter selects the first character in the font btiffer to be loaded. Parameter 
value 0 means 2/0, 1 means 2/1, 2 means 2/2, ... 94 means 7/14, and 95 means 7/15. 

If the device supports only 94-character buffers, (Level 2 conformii^ video products that 
do not include the 8-bit Inter&ce Architecture Extension), attempts to start loading at 
location zero will cause the first character definition to be ignored, and the second character 
definition will be used for position 2/1. Any attempt to start loading beyond (or continue 
b^ond) location 94 will also be ignored. 

If the device supports 94- or 96-character buffers, (required for printers and Level 3 or 
higher conforming video products), the Pcss parameter (see below) determines whether the 
font file is being loaded for a 94-character or 96-character set. If a 94-character set is being 
loaded, the restricted 94-character buffer interpretation of Pen applies. If a 96-character 
set is being loaded, attempts to start loading at location zero will load the character 2/0, 
and loading at a location greater than 95 will be ignored. 
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Conforming software loading 94-diaracter sets or font buffers, will not specify values less 
than one or greater than d4. Conforming software loading 96-character fonts will not 
specify values greater than 95. 

4.1.3 Parameter (Pe): Erase Control 

The third paramet^ controls which characters are erased before loading takes place 
according to: 

0 - Erase all characters in the specified font buffer (default) 

1 - Erase only the characters that are loaded 

2 - Erase aU characters in all font buffers 


A parameter value of 1 permits the changing of one or more characters in the specified 
font without affecting the remaining characters of that font. Characters which have been 
erased firom the buffer and not redefined are represented in the visual display by the error 
character (reverse question mark). 

Guidieljne: 

For video terminals, conforming software should only use the parameter value of 2 (erase 
all characters in all font buffers) in response to an explicit user request. 

4.1.4 Parameter (Pcmw): Character Cell Matrix Width 

The fourth parameter defines the limit of the character cell matrix width in pixels of the 
font being loaded. Note that legal values for this parameter are dependent on the values of 
the Font Set Size parameter and the Font Usage parameter, and may vary firom device to 
device. 

The legal combinations of these three parameters must be clearly defined in the product 
literature for conforming terminals. Illegal values of the Character Cell Matrix Width 
parameter cause the remainder of the load sequence to be ignored. Changes to this 
parameter since the last DECDLD sequence to this buffer will result in the erasure of the 
entire set, and cause a new load to start. 

Gnidelinet 

Implementations may discard pixels beyond the width of the character cell specified by 
thi« parameter. Software can use the Character Matrix T^dth parameter to obtain device 
independent, predictable results. 


Additional Requirements for Video Terminals: 

For video terminals, some values of the Character Cell Matrix Width parameter also 
specify the Character Cell Matrix Height, as shown in the table below. If one of these 
parameters is specified, the Character C^U Matrix Height (Pcmh) parameter is ignored. 

Possible values of the parameter for conforming devices include: 

0 - Device default 

1 - Not used, illegal 

2 - 5 X 10 matrix (width x height) 

3 - 6 X 10 matrix (width x height) 

4 - 7 X 10 matrix (width x height) 
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5- 5 pixel wide maixix 

6- 6 pixel wide matrix 

7- 7 pixel wide matrix 

8- 8 pixel wide matrix 

9- 9 pixel wide niatrix 

10 - 10 pixel wide matrix 

11 - 11 pixel wide matrix 
12-12 pixel wide matrix 


A parameter value of 0 indicates that the width (or matrix) of the character ceil is the 
device default, which is dependent on the implementix^; device. 

Guideline: 

7 X 10 is the device defaidt for Level 2 video devices. 5 x 10, 6 x 10 and 7 x 10 character 
cells are alwa 3 rs scaled for 'VT220 compatibility. 

4.1.5 Parameter (Pee): Font Set Size (Video Terminais Oniy) 

This parameter specifies the intended visual rendition of the font file, and is used by 
the device when such restriction can affect the use of the loaded set. For example, some 
implementations restrict a loaded font file to use in an 80-column or 132-column screen. 
Note that legal values for this parameter are dependent on the values of the Character Cell 
Matrix Size parameter and the Font Usage parameter, and may vary from device to device. 

The legal combinations of these three parameters must be clearly defined in the product 
literature for conformii^ terminals. Illegal values of the Font Set Size parameter cause 
the remainder of the load sequence to be ignored. Changes to this parameter since the last 
DECDLD sequence to this buffer wiU restilt in Hie erasure of the entire set, and cause a 
new load to start. 

Possible values of the parameter for conforming devices include CVT420 Example): 

0 - Device d^ault (80 columns, 24 lines, not mandatory) 

1-80 columns, 24 lines, (normal rendition) 

2 - 132 columns, 24 lines, (normal rendition) 

11 - 80 columns, 36 lines, (normal rendition) 

12 - 132 columns, 36 lines, (normal rmidition) 

21-80 columns, 48 lines, (normal rendition) 

22 - 132 columns, 48 lines, (normal rendition) 

NOTE 

The values f<nr this panonetOT may be extended in the future to include character 
pitidi and other physical rendition values which may affect the use of the loaded 
set. 
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4.1.6 Parameter (Pu): Font Usage 

The sixth parameter defines the loaded font file as either a text font file or as a full cell 
font file. Full cell font files can individually address all pixels in a cell, while text font 
files may not be able to address all pixels individually. Text font files may also define the 
centering and spadng characteristics of the area aroimd the character ceU. Note that legal 
values for this parameter are dependent on the values of the Character Cell Matrix Size 
parameter and the Font Set Size parameter, and may vary firom device to device. 

The legal combinations of these three parameters must be clearly defined in the product 
literature for conforming terminals. Illegal values of the Font Usage parameter cause the 
remainder of the load sequence to be ignored. Changes to this parameter since the last 
DECDLD sequence to this buffer wiU result in the erasure of the entire set, and cause a 
new load to start. 

Possible values of this parameter for conforming devices are; 

0 - Device default (Guideline: t^ on VT220) 

1 - Text 

2 - FuU CeU 


4.1.7 Parameter (Pcmh): Character Cell Matrix Height 

The seventh parameter defines the limit of the character ceU matrix height in pixels of 
the font file being loaded. Note that legal values for this parameter are dependent on the 
values of the Font Set Size parameter and the Font Usage parameter, and may vary from 
device to device. 

The legal combinations of these three parameters must be clearly defined in the product 
literature for conforming terminals. Dlegal values of the (Uiaracter CeU Matrix Height 
parameter cause the remainder of the load sequence to be ignored. Changes to this 
parameter since the last DECDLD sequence to this buffer wUl result in the erasure of the 
entire set, and cause a new load to start. 

On video terminals, some values of the Character CeU Matrix Width (Pcmw) parameter 
also specify the Character CeU Matrix Height. If one of these Pcmw parameters is specified, 
the Character CeU Matrix Height (Pcmh) parameter is ignored. 

The value of this parameter indicates the hei^t of the Character CeU Matrix. For example, 
a value of 15 indicates a 15-pixel hig^ character cdl matrix. If a parameter value of 0 is 
specified, this indicates that the height of the character ceU matrix is the device default, 
which is dependent on the implementing device. 

Guideline: 

Implementations may discard pixels beyond the hei^t of the character ceU specified by 
this parameter. Software can use the Character Matrix 1^dth parameter to obtain device 
indei>endent, predictable results. 
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4.1.8 Parameter (Pcss): Character Set Size 

The eis^th parameter controls the size of the associated character set (and modifies the 
interpretation of the C!haract^ Number (Pen) parameter). The value of the parameter 
indicates tbe size of character set associated with the downloaded font according to: 

0 • 94-character set (default) 

1 - 96-character set 


A parameter value of 1 permits the loadii^^ of the 2/0 and 7/15 characters in the font. And 
requires that the 96-diaracter designating escape sequences (refer to the "Code Extension 
Layer" section) be tused to designate the font. 

The Final character { (7A1) indicates that this DCS string is the DECDLD control function. 
The data foUowii^ it up to the String Terminator (ST) is firom 2/0 to 7/14 and represents 
the actual font load command string. 

4.2 COMMAND STRING FORMAT 

The S 3 mtax of the DECDLD command string is as follows: 

1. Dscs • (Select Character Set) The command string begins with a character set 
designation string, whidi defines the intermediate and final characters of the escape 
sequence which will subsequently be used to designate the loaded font as a character 
set. 

2. Sxbp • The final character of the dbaracter set designation strii^ is followed by a 
sequence of sixel bit pattern strings, each string containing the complete definition 
for one diaracter of the font. Refer to subhead 10.4.2.2. Devices which support only 
94-character sets should include only 94-sixel bit pattern strings in a single DECDLD 
command. Devices which support 96-character sets may include up to 96 sixel bit 
pattern strings in a single DLD command. Additioxial patterns will be ignored as 
necessary, but will not cause the command to be aborted. 

3. ST - The String Terminator (ST, 9/12) control. 

4.2.1 Character Set Designation String 

The Dscs string is a set of zero, one, two, or three ANSI intermediates, followed by an 
ANSI final. (Dscs « 1 1 1 F). The Dscs defines the character set for the loaded font, and is 
used in the SCS (Select Character Set) escape sequence. Note that the same Dscs can be 
used to desoribe a 94-character or 96-character graphic set. The Pcss parameter indicates 
which initial intermediate character of the SCS sequence is to be used to designate the 
diaracter set (see below). Refer to the DEC STD 070-3 and DEC STD 070-5 for a complete 
description of the escape sequence format, and particularly the SCS sequence. 

The SCS sequence for designating the loaded font will be of the form: 

ESC ( Dscs - Load the set into GO (94-character set) 

ESC ) Dscs - Load the set into G1 (94-diaracter set) 

ESC * Dscs - Load the set into G2 (94-character set) 

ESC + Dscs - Load the set into G3 (94-character set) 

ESC - Dscs - Load the set into G1 (96-dhLaracter set) 

ESC . Dscs - Load the set into G2 (96-character set) 

ESC / Dscs - Load the set into G3 (96-character set) 


Digital internal Use Only 


EL-00070-10 


04-0ct-1990 


Changes to the Dscs string since the last DECDLD sequence to this buffer will result in 
the erasure of the entire set, and cause a new load to start. 

Examples of Dscs: 

1. Dscs s sp ® 

Defines the loaded font file to be a DRCS set. (This particular value is the recommended 
value for user defined sets for either 94-character or 96-character graphic character 
sets.) 

2. Dscs s B 

Defines the loaded font file to be ASCII (94-character), or ISO Latin Alphabet Nr 2 
supplemental (96-character), depending on the value of the Pcss parameter. 

3. Dscs s & % C 

Defines the loaded font file to an as yet unregistered set. 

4.2.2 Character Font Data 
4.2.2.1 Summary 

The remainder of the conunand data is a sequence of sixel bit pattern strings (Sxbp string), 
each defining the pattern for a single character in the font. Each Sxbp string is separated 
by a semicolon character (;, 3/11). Each individual Sxbp string consists of several sequences 
of sixel data (refer to subhead 10.4.2.2.3) which define the individual horizontal scans of 
the character pattern, each sixel data sequence bmng terminated by a slash character (/, 
2/15). 

Bit combinations 0/8 to 0/13 may be included m the command string, and have no affect 
on the interpretation of the data. They permit convenient formatting of command strings 
when being created by t^ editors since TAB, CR, and LF are included in this range. The 
following bit combinations are considered as error conditions when they occur witlun the 
character font data. Because existing implementations differ in how they handle these bit 
combinations, their processing is UNDEFINED by the architecture. It is not mandatory, 
but recommended that future implementations adopt the following conventions for these 
bit combinations. 

• CO controls 0/0 to 0/7 and 0/14 to 1/15 should be ^ored except for ESC 1/11 which 
terminates the DCS and begins a new sequence. ESC followed immediately by \ 5/12 
is the 7-bit representation of STRING TERMINATOR and ends the DECDLD normally. 
Othor ESC sequences should cause the entire DECDLD command string to be ignored 
(aborted). 

• 2/0 and 7/15 should be ignored. 

• 2/1 to 3/14 witii the exception of 2/15 and 3/11 should be ignored. 

• Cl controls 8/0 to 9/15 should abort the DECDLD conunand string except for 9/12 
STRING TERMINATOR vAdcii ends the DECDLD normally. 

• 10/0 and 15/15 should be ignored. 

• 10/1 to 15/14 should be interpreted as 2/1 to 7/14. 

These characters should not be used by conforming software (except 2/15, 3/11, and 
STRING TERMINATOR). 
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4.2.2.2 Sixei Definition 

A sixei is oa encoded representation of six pixels. It is used to transfer pixel information 
in Device Control Strings. Sixei data consists of characters from ? (3/15) through (7/14), 
in whidi the character code represoats a binary bit pattern. Each character represents 
a binary value plus 63 decimal. Thus 3/15 represents the binary value OOOOOO, and 7/14 
represents 111111. Tire bits are represented as a vertical, 1 by 6 pixel matrix ("the sixei"), 
with the least significant bit at the top. A reset bit (zero) specifies the font background, 
and a set bit (one) specifies the font foreground. 

NOTE 

Refer to DEC STD 070-9 Sixei Graphic* E^engUm for a more complete description 
of the conversion algoriihms. Note that DECDLD command string uses the 
sixei data fwmat, hat does not use the contitd ftmctions as defined in title Sixei 
Graphics Extension. 

4.2.2.3 Sixei Bit Pattern 

Td load the logical pixel pattern for an individual character in a font (one S:d)p), a sequence 
of sirel characters is sent, with each sixei specifying one vertical column of six logical 
pixels. After each character the font pattern scan advances horizontally by one logical 
pixel. This sequence continues until either a scan terminator (the / character, 2/15) is 
recmved, a sixei bit pattern terminator (the ; character, 3/11) is received, or a STRING 
TERMINATOR (9/12) is received. If the number of characters in a horizontal scan is 
greater than the width of the loaded character (as defined in the Character Cell Matrix 
Size parameter of the introducer sequence), the characters in excess of the loaded character 
width are ignored. 

The scan terminator character (/, 2/15) advances the font pattern scan to the next lower 
row of six vertical logical pixels. When the height of a loaded character (as defined in the 
Character Cell Matiix Size parameter of the introducer sequence) is not a multiple of six, 
the hi{^ order bits of the sixei values are ignored on the last row of the font pattern. If the 
munber of horizontal scans is greater than the height of the loaded character (divided by 
six), the characters in excess of the loaded character height are ignored. 

Any pixels of a loaded character that are not specified are set to zero. This mig^t occur 
either as a result of a horizontal scan being terminated before the pattern has reached 
the frill width of the loaded character, or as the result of the sixei bit pattern string being 
terminated before the frill character matrix has been defined. 
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The following picture shows the mapping of sixels onto an 8 x 10 logical pixel character 
cell: 
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The rows of numbers on the top and bottom relate to the order in which sixel values are 
sent to the terminal 

The following picture shows the mapping of Sixels onto an 10 x 20 logical pixel fuU-cell 
character cell: 
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The rows of numbers on the top and bottom relate to the order in which sixel values are 
sent to the terminal 
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4.3 ALGORITHM 
State Affected: 


FONTS ARRAY [ 1 . . MAX_NtJM_FONTS ] OF FONT_BUFFER_TYPE .• 
CELLJJDMBERs CHARACTER_VALOE_TYPE; 

FONT NUMBERS 1 . .MAX_NUM_FONTS; 

FIRST CHARACTERS CHARACTER_VALnE_TYPE; 

ERASE^CONTROL s <ERASE_THIS JFONT, NO ERASE , ERASE^ALLJFONTS ) ; 
CELLJWIDTHs CELLJWIDTH TYPE; * 

CELL HEIGHTS CELL HEIGHT TYPE; 

SET_SIZE s (EIGHTy70NE_ThTrTY_TN0) ; 

CElZ_USAGE s (TEXT, FUl5I_CELL) ; 

I CHARACTER_SET_SIZE s (94 , 96) ; 

CHARACTER* SET_DESIGNATOR s 

ARRAY [T, -MAX^LENGTH^DESIGNATOR] OF 
DES IGNATOR_CHARACTER_TYPE ; 

Algorithm: 


CONST 

I 

I 

I 

I 


I 


MAXJMUM_FONTS » 1; 

MIN_CHARACTER VALUE « 0; 

MAX^CHARACTER^VALUE » 95; 

(* D«victta which are not required to support 

96-character sets may set these values to 1 and 94 *) 

MAX_CELL WIDTH » 8; 

MAX^CELLJiEIGHT « 10; 

(* These values may vary from device to device *) 

MAX_LENGTH_DESIGNATOR * 3; 

ON * TRUE; 

OFF « FALSE; 


TYPE CELLJWIDTH TYPE « l..MAX_CELL WIDTH; 

CELLJHEIGHT_TYPE * 1 . .MAX_CELL_HEIGHT; 

CHARACTER CELL_TYPE » 

ARRAY [ CELL J?IDTH_TYPE, CELL J!EIGHT_TYPE] OF BOOLEAN; 

CHARACTER VALUE_TYPE * 

MIN_CHA^CTER_VALUE . . MAX_CHARACTER_VALUE ; 

FONT^BUFFER^TYPE * 

ARRAY {CHARACTER_VALUE_TYPE] OF CHARACTER_CELL_TYPE ; 

VAR FONTS ARRAY I1..MAXJIUM FONTS] OF FONT BUFFER_TYPE; 
CELL NUMBERS CHARACTER VALUE TYPE; * 

FONT* NUMBERS 1.,MAXJ!IUM FONTS; 

FIRST CHARACTERS CHARAcfER_VALUE_TYPE; 

DRCS ERASE CONTROLS 

(ERASE_THIS JFoNT, N0_ERASE , ERASE ALLJFONTS ) ; 

* CEIX WIDTH s*CELL WIDTH TYPE* 

CBLL*HEIGHTs CELL HEIGHT_TYPE; 

SBT_SIZEs (EIGHTyToNE THIRTY TWO); 

CELL USAGES (TEXT, FULL_CELL)7 
j CHARACTER_SET_SIZE s (94, 96) ; 

VALID_DRCS SYNTAX; BOOLEAN; 

DRCS STRING_TERMINATED s BOOLEAN; 

H,V,Ns INTEGER; 


PROCEDURE GET NEXT EVENT (VAR EVENT: EVENT_BUFFER_TYPE) ; EXTERN; 
PROCEDURE GET*DRCS*PARAMETERS (EVENT: EVENT_BUFFER_TYPE) ; FORWARD; 
I PROCEDURE GET^CHARACTER SET_DESIGNATOR; FORWARD; 

PROCEDURE FILL CELLS; FORWARD; 
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PROCEDURE EXECUTE_FONT LOAD (EVENT: EVENT_BUFFER_TYPE) / 

(* 

This routine processes DECDLD font load command strings. 

The input to this routine is the parsed DCS introducer 
sequence. Successive calls are made to the ANSI parser 
(GETJtlEXT^EVENT) to input a character at a time for 
processing. The routine will not exit until a String 
Terminator (9/12) is received. 

♦) 

BEGIN 

(* first, process the DCS introducer sequence parameters *) 

GET DRCS PARAMETERS (EVENT) ; 

IP ^h^ID*DRCS SYNTAX THEN 
BEGIN 

DRCS_STRING_TERMINATED : - FALSE ; 

if the sequence is valid, get the character set designator *) 
GET CHARACTER_SET DESIGNATOR; 

IF ^ID_DRCS SYNTAX THEN 
BEGIN 

{* erase according to the erase parameter *) 

CASE DRCS ERASE CONTROL OF 
ERASE_THIS_FONT : 

FOR CELL NUMBER :« 

MIN CHARACTER_VALUE TO MAX_CHARACTER_VALUE DO 
FOR H:» 1 TO MAX_CELL_WIDTH DO 
FOR V:* 1 TO MAX_CELL_HEIGHT DO 

FONT [FONTJIUMBER, CELL NUMBER, H, V] OFF; 
ERASE_ALL_FONTS : "" 

FOR N:- 1 TO MAX_NUM_FONTS DO 
FOR CELL NUMBER 

MIN CHARACTER_VALUE TO MAX_CHARACTER_VALUE DO 
FOR H:- 1 TO MAX_CELL_WIDTH DO 
FOR V:* 1 TO MAX_CELL_HEIGHT DO 

FONTIFONT_NUMBER,CELL_NUMBER,H,V] OFF; 

OTHERWISE IGNORE; 

END; 

{* then process the command string *) 

FILL^CELLS; 

(* on overflow, keep going until String Terminator *) 

WHILE NOT DRCS STRING_TERMINATED DO 
BEGIN "" 

GETJNEXT EVENT (EVENT); 

IF (EVENT. EVENT CODE - CONTROL CODE) 

AND (EVENT. CODE^VALUE « 156) TlffiN 
DRCS STRING_TERMINATED:« TRUE; 

END; " 

END; 

END; 

END; 
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FEOCEDOHE GET DECS^PARiy^TERS ; 

{* 

This routins gets the DCS introducer sequence parameters 
from the event buffer and sets the appropriate state 
prior to loading the font. 

*) 

BEGIN 

VALID_DRCS_SYNTAX:- TRUE; 

the first parameter is the font number to be loaded *) 

IF <EVENT.FARAMETERS{1] » 0) OR ( EVENT. P ARAMETERS C 1] » 1) THEN 
FONT NUMBER:- 1 

ELSE VALID_DRCS_SYNTAX:- FALSE; 

the second parameter is the first character to be loaded *) 
FIRST CHARACTER:- EVENT. PARAMETERS [2] ; 

IP <pTrST_CHARACTER - 0) or (FIRST_CHARACTER > 95) THEN 
FIRST_CHARACTER:- 1; 

the third parameter is the erase control specifier 
CASE EVENT. PARAMETERS [3] OF 

0: DRCS ERASE CONTROL:- ERASE_THIS PONT; 

Is DRCS“"eRASEjC0NTR0Ls» NOJERASE; “ 

2s DRCS^ERASE CONTROL:- ERASE_ALL_FONTS; 

OTHERWISE VALID DRCS_SYNTAXs- FALSE; 

END; “ 

the fourth parameter is the cell width or size *) 
CELL_HEIGHTs- MAXjCELL_HEIGHT; assume no cell height 

pareuneter at start 

CASE EVENT. PARAMETERS [4 3 OF 

0: CELL WIDTH:- MAX CELL WIDTH; (* 0 is device default *) 

Is VALID DRCS_SYNTAXs- FM.SE; <* 1 is illegal*) 

2s CELL WIDTH?- 5; 

3s CELLJWIDTHs- 6; 

4s CELLJWIDTHs- 7; 

OTHERWISE CELL WIDTH : - EVENT . PARAMETERS 1 4 ] ; 

END; 

IF (CELL WIDTH > MAX CELL WIDTH) 

THEN CEii._WIDTH:- l^_CELL_WIDTH; 

C* the fifth parameter is the set size *) 

CASE EVENT. PARAMETERS C5 3 OF 
0,1: SET SIZE:- EIGHTY; « 

2s SET_SIZEs- ONE_THIRTY TWO; 

OTHERWISE VALID DRCS^SYNTAXs- FALSE; 

END; 

(* the sixth parameter is the font usage *) 

CASE EVENT. PARAMETERS [63 OF 
0,1: CELLJOSAGEs- TEXT; 

2 s CELL_USAGEs- FULLjCELL; 

OTHERWISE VALID_DRCS SYNTAX:- FALSE; 

END; 

(* the seventh parameter (if present) is the cell height *) 

CASE EVENT. PARAMETERS [73 OF 

0: CELL^HEIGHTs- MAX CELL HEIGHT; (* device dependant default 

*) 

OTHERWISE CELL HEIGHT:- EVENT . PARAMETERS [ 7 3 ; 

END; ~ 

IF (C£LL_H£IGHT > MAX CELL_HEIGHT) 

THEN CELL^HEIGHTs- Mix_CELL_HEIGHT; 

(* the eighth parameter is the character set size *) 

CASE EVENT . PARAMETERS [83 OF 
0: CHARACTER_SET SIZE:- 94; 

Is CHARACTER_SET“” SIZE:- 96; 

OTHERWISE VALID_DRCS_SYNTAX:- FALSE; 

END; 

END; 
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PROCEDURE GET CHARACTER_SETJDESIGNATOR; 

(* 

This routine parses the character set designating escape 
sequence to be associated with the loaded font. This sequence 
must immediately follow the DCS introducer sequence. 

Refer to DEC STD 070*5 for a description of the character set 
table and the subsequent designation procedure. 

BEGIN 

(* accept characters until final or String Terminator *) 

N:* 1; 

REPEAT 

GET NEXT EVENT (EVENT) ; 

CASE EVENT. EVENT_CODE OF 

GRAP HI OPCODE : put legal characters in the buffer *) 

BEGIN 

IF (N-1) AND (EVENT. CODE_VALUE >• 32) 

AND (EVENT. CODE VALUE <- 47) THEN 

CHARACTER SET^TABLE [ 4 ] . FIRST_INTERMEDIATE s « 

EVENT. CODE VALUE; 

IF (N-2) AND^ (EVENT. CODE_VALUE >- 32) 

AND (EVENT. CODE_VALUE <« 47) THEN 

CHARACTER SET_TABLE ( 4 ] . SECOND_INTERMED lATE : « 

EVENT . CODE_VALUE ; 

IF (EVENT. CODE_VALUE >- 48) 

AND (EVENT. CODE_VALUE <» 126) THEN 

CHARACTER SET TABLE [4] .FINAL:* EVENT . CODE_VALUE ; 

IF (EVENT. CODE JVALUE >- 32) 

AND (EVENT. C0DE_VALE <* 126) THEN N:* N-l-1; 

END; 

CONTROL CODE: (* terminate on String Terminator ^ 9/12 *) 

IF EVENT. CODE_VALUE - 156 THEN DRCS_STRING_TERMINATED : * TRUE 
ELSE IGNORE; (* ignore other control characters *) 
OTHERWISE IGNORE; (* ignore escape and control sequences *) 
END; 

UNTIL ( (EVENT. EVENT_CODE * GRAPHIC_CODE) 

AND ( (EVENT. CODEJTALUE >« 64) AND ( EVENT. CODE_VALUE <- 126))) 

OR DECS STRING_TERMINATED; 

END; 
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PROCEDURE FILL_CEIiLS; 
i* 

ThLa routine processes the sixel command string and loads 
the character cells in succession, starting with the first 
character specified in the introducer sequence. 

*) 

VAR NEXT_CELL: BOOLEAN; 

BEGIN 

(* start with the first character as specified *) 

CELL NUMBERS- PIRST_CHARACTER; 

NEXT* CELLS- TRUE; 

REPEAT 

clear the cell if not already cleared *) 

IF NEXT CELL THEN 

begin"* 

IF DRCS_ERASE_CONTROL - NO_ERASE THEN 
FOR h7- 1 TO MAX CELL WIDTH DO 
FOR Vs- 1 TO WAX^CELL HEIGHT DO 

FONT [FONT NUMBER, CeElJIUMBER^H^V] s- OFF; 

Hs- 1; “■ 

Vs- 1; 

NEXT CELLS- FALSE; 

END;*" 

now, fill it *) 

GET NEXT EVENT (EVENT); 

CASE EVraT.EVENT_CODE OF 
GRAPHIC CODES 
BEGIN*" 

(* convert sixels into the font memory *) 

IF (EVENT. CODE VALUE >- 63) 

AND (EVENT. CODE VALUE <« 126) THEN 
BEGIN *" 

EVENT. CODE_VALUE.s- EVENT, CODE VALUE - 63; 

IF H <» CELL WIDTH THEN " 

BEGIN *" 

FOR Ns- 1 TO 6 DO 
BEGIN 

IP V+N-1 <- CELL_HEIGHT THEN 
BEGIN 

IF ODD (EVENT. CODE_VALUE) THEN 

FONT CFONT_NUMBER,CELL_NUMBER,H, V+N-1] 8* ON; 
i* shift in one bit at a time *) 

EVENT. CODE_VALUEs» EVENT . CODEJTALUE DIV 2; 

END 

ELSE IGNORE; 

END; 

Hs- H+1; 

END 

ELSE IGNORE; 

END 

ELSE 

BEGIN 

CASE EVENT. CODE_VALUE OF 

(* / terminates a horizontal scan *) 

47s BEGIN Hs- 1; Vs- V+6; END; 

59s (* ; terminates a cell, go to the neact *) 

BEGIN 

NEXT_CELLs- TRUE; 

CELL^NUMBERs- CELL_NUMBER+1 ; 

Hs- 1; Vs- 1; 

END; 

OTHERWISE IGNORE; 

END; 

END; 

END; 
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CONTROL^CODE : terminat.e on String Terminator, 9/12 *) 

IF EVENT. CODE_VALUE - 156 THEN DRCS_STRING_TERMINATED TRUE 
ELSE IGNORE; (* ignore other control characters *) 
OTHERWISE IGNORE; (* ignore escape and control sequences *) 
END; 

UNTIL (CELL_NUMBER > MAX_CHARACTER_VALUE) 

OR (DRCS_STRING_TERMINATED) ; 

END; 
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5 DRCS FONT LOADING EXAMPLES 

The following are examples of DECDLD font loading sequences: 


5.1 EXAMPLE ONE 

DCS l;l;0;0;0;0{spS 

/ 

????????/????????; 

~8aeSS-?/~HHWMW~?; 

TTTTTTTT/TTTTTTTT . 

ST 

Notes: 

1. This load is into the first DRCS font buffer. 

2. The font is an 80 column t^ font with a character cell matrix size of 7 x 10. 

3. "sp” represents the Space character (2/0). 

4. The loaded character set can be des^poated usii^ the following Select Character Set 
(SCS) sequences: 

ESC ( sp <9 
ESC ) sp @ 

ESC * sp @ 

ESC -I- sp @ 

5. Carriage return is ignored in the sequence and can be used to facilitate formatting and 
editing of the command string. 

6. The first dbaracter loaded is a solid rectangle. 

7. The second duuracter loaded is blank. 

8. The third character loaded is a rectangular box. 

9. The fourth character loaded is a set of horizontal stripes. 


5.2 EXAMPLE TWO 

DCS 5 ; 65 ; 1 ; 2 ; 2 ; 1 { B 
???/??????????/?????; 

/- ; 

?????/ 

??—??/??—? 

ST 

Notes: 

1. This load is into the fifth DRCS font buffer. Since only one buffer is required for Level 
2 conformance, the entire load sequence may be ignored. 

2. The load will start with the 65th character in the set, which would be the character 6/1 
(ASCn ’a*). 

3. Only the characters actually loaded will be erased. Thus, this load could be used to 
redefine only the lower case characters. 

4. The font is a 132 column text font with a character cell matrix size of 5 x 10. 
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5. B is the designator for the ASCII character set - therefore, this font replaces ASCII, 
and may be des^piated using the following Select Character Set (SCS) sequences: 
ESC(B 
ESOB 
ESC*B 
ESC-i-B 


6. The first character loaded is blank. 

7. The second character loaded is solid. 

8. The third character loaded is top 6/10 blank, bottom 4/10 solid. 

9. The fourth character loaded is a ihick vertical bar. 


5.3 EXAMPLE THREE 

DCS 1 ; 65 ; 1 ; 4 ; 2 ; 2 ; 16 ; 1 { B 
???/??????????/?????; 

/ / 

?????/{{{{{/ /?????; 

?—?/?—?/?—? 

ST 

Notes: 

1. The font is a 132-column, full-cell font with character matrix size of 4 x 16 

2. The first character loaded corresponds to the 6/0 position in the code table. 

3. The first character loaded is blank 

4. The second character loaded is solid 

5. The third character loaded has the top half blank, and the bottom half solid 

6. The fourth character is a thick vertical bar 

7. The excess Sixel information (outside of the 4 x 16 cell) is ignored 

8. "B" could be confused with the ASCII designator, however, since Pcss is 1, making 
this a 96-character soft character set, this font does not replace the ASCII font. (It 
is, however, the registered designator for the supplemental character set of ISO Latin 
Alphabet Nr 2, and would replace tiiat set, if it were present in the device.) 

9. The character set can be des^piated using tiie 96-character SCS sequence. The Dscs is 
"B". The SCS sequences are: 

ESC-B 

ESC.B 

ESC/B 


r 
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6 CHANGE HISTORY 

6.1 Revision 0.0 To AX10 

1. Added Introduction, Terminology, and Functional Description sections. 

2. Revised the DECDLD command format. 

3. Restricted the legal values for the Font Number parameter. 

4. Restricted the legal values for the First Character parameter. 

5. Added a parameter value to erase all font definitions (User Preference Feature). 

6. Added parameters for Character Cell Matrix Size, Font Set Size, and Font Usage. 

7. Extensively revised the section on Command Stiii^ Format. 

8. Added the DECDLD a^orithm. 

9. Added examples for DECDLD. 

10. Added references to the Character Cell Display section for character set tables of 
designating escape sequences. 

6.2 RevAXIOtoAXII 

1. Added statement that starting to load at location greater than 94 will be ignored in 
level 2. 

6.3 Rev AX11 to AX12 

1. Added support and Character Set Size parameter for 96-character graphic charcter 
sets for Level 2 and 3 DRCS. 

2. Modified meaning of Character Matrix parameter to mean Character Matrix A^dth 
parameter as a modification to Level 2 DRCS. 

3. Added Character Matrix Height parameter as a modification to Level 2 DRCS. 

4. Added example containing new parameters. 

5. Extended b^iavior of Font Number parameter when parameter is omitted or zero. 

6. Clarified behavior of DRCS which replace stmidard character sets when the DRCS is 
erased. 

7. Updated algorithm to r^ect new parameters and 96-character graphic character set 
support. 

6.4 Rev AX12tO AX13 

1. Chained title to "Video & Printer Systems Reference Manual”. 

2. Clarified use of terms "font", "font file”, and "character set" to be more consistent with 
printer terminology. "Font file" refers to a sequence of bit patterns that define the 
graphic symbols of a coded character set. "Fonts" are styles (an instance of a type 
family). 
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3. Added minimum requirements for Hardcopy Display service class (three 96 character 
buffers). 

4. Clarified that DRCS can be used as the User Preference Supplemental Set. 

5. Clarifed effect of DECDLD on characters already on the page in printers (do not 
change). 

6. Specified behavior of DECSTR, RIS, and DECSCL with respect to DRCS buffers for 
both video and hardcopy devices. 

7. Clarified differences in behavior of DECDLD parameters for video and hardcopy 
devices (Pfii, Pcmw, Pss, Pcmh). Printers have three buffers wiiTiimiiTn- Printers never 
deduce Pcmh from Pcmw. Pss (Font set size) is for video terminals only. Extended list 
of possible values for Pss to refiect VT420 implementaUon. 

8. Specified Dscs may include up to 3 intermediates in addition to the first SCS 
intermediate which specifies the G-set. 

9. Included error handling recommendations for unexpected bit combinations. ESC and 
Cl controls abort DECDLD (except ST and DCS). 10/1 to 15A4 should be interpreted as 
2/1 to 7/14. This reflects latest consensus among hardcopy and video implementations. 

10. Clarified that ST may terminate an individual character load. 
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APPENDIX A REFERENCED DOCUMENTS 


A.1 EL-Class Digital Documents 


EL-Class Numb«r Document Title 


EL-00070-01 

EL-00070-03 

EL-0O070-0S 

EL-00070-09 


DEC STD 070-1 Vfdto Systems Rsfsrsncs Meuniat - Concept and Conformancs 
Criteria 

DEC STD 070-3 Video Systems Standard - Code Extertsion Layer 
DEC STD 070-S Video Systems Refererrce Manual - Character Celi Dispiay 

DEC STD 070-9 Video and Printer Systems RefererKS Manual - SIXEL Graphics 
Extension 


Use VTX SMC to order copies of EL-dass documents from Standards and Methods Control. 
Send distribution questions to JOKUR::SMC or call DTN: 287-3724. 
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VIDEO SYSTEMS REFERENCE MANUAL 
User Defined Keys Extension 


Document Identifier: A- DS - EL0007 0 - 01 1 - 0 Rev. AXlO, 15-May-83 


ABSTRACT: This section describes the interface to load and invoke 

User Definable Keys (UDK), which form an extension to the Level 2 
Character Cell Display service class. 


APPLICABILITY: SARA Formal Cross - Component Standard. Mandatory 

for Engineers designing hardware for terminal products and 
Software Engineers designing programs using terminal interfaces. 
Additional requirements are defined in the section on "Concepts 
and Conformance Criteria". 


STATUS: FOR REVIEW ONLY 


+ - + 

! This document has been placed in the SARA "Formal ! 

I Cross - Component Standard" category. The material contained I 

I within this document is assumed to define mandatory standards i 

I unless it is clearly marked as (a) not mandatory or | 

! (b) guidelines. Material which is marked as "not mandatory" is i 

I considered to be of potential benefit to the corporation and | 

i should be followed unless there are good reasons for I 

I non-compliance. "Guidelines" define approaches and techniques | 

I which are considered to be good practice, but should not be | 

! considered as requirements. The procedures for modifying or 

evolving this standard are contained within the contents of : 
this document. 

+ -- + 
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11.1 INTRODUCTION ' 

User Defined Keys are a Level 2 extension, which provide the 
capability of loading into the terminal key definition strings 
which subsequently be transmitted using a single key stroke. The 
format for loading key definition strings is intended to be 
extensible to future devices which have more complex keyboards, 
larger memories, or other forms of input processing. Conforming 
Level 2 devices which implement this extension, however, are 
required to provide only fifteen programmable keys> with a total 
buffer space of at least 256 characters. 

It should be noted that conformance to this standard does not 
require the ability to retain the key definitions in non-volatile 
memory. That is, the loaded definitions may be lost if the 
terminal is powered off. On the other hand, non-volatile storage 
and restoration of the key definition strings is not precluded. 
Furthermore, conformance does not preclude a device from providing 
the ability to interact locally with the key definitions (input, 
edit, or delete), provided that it is done in keeping with the 
intent of this standard. 
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11.2 FUNCTIONAL DESCRIPTION 

11.2.1 Programmable Keys 

The keys which may be programmed in Level 2 devices are all of the 
keys in the Application Function Key Row, when used in combination 
with the Shift key (see the section "Keyboard Processing" for a 
complete description of the keyboard) . The keys may only be 
programmed, and are only operational, when the terminal is in 
Level 2 operation (as selected by the control function Select 
Conformance Level (DECSCL); see the section "Terminal Management" 
for a complete description of the DECSCL function). When the 
terminal is in Level 1 operation (or in VT52 mode), the DECUDK 
control function is ignored and the keys are "dead" (i.e., they do 
not transmit and do not keyclick). 

11.2.2 Default Definitions 

Programmable keys which have not been defined, or have had their 
definitions erased, do not transmit and therefore do not keyclick. 
Programmable keys which have been defined do keyclick, and are 
also subject to all of the requirements of the lower level 
transmission layers, such as XON/XOFF flow control, rate limiting, 
and Cl Control Code translation. 

11.2.3 Key Definitions 

The definition for each key consists of a variable length 
character string of 0 to 255 7-bit or 8-bit characters. Each 
character in the string is a code in the range 0/0’ through 15/15. 
Thus, any character in the code table may be included within a key 
definition . 

Buffer space for the key definitions is supplied on a first come 
first serve basis. Once the supplied buffer space is used up, no 
more keys may be defined unless space is freed up. Space may be 
freed up either by redefining previously defined keys using 
shorter strings than before, clearing key definitions using the 
DECUDK control function, or clearing the entire definition set 
(through a terminal power up reset). 
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11.2.4 Lock Control 

The terminal uses a special lock to arbitrate the programming of 
User Defined Keys. This lock can be turned on or off through 
Setup mode. It may also be turned on (but not off) from the host 
using the DECUDK control function. The lock acts globally over 
all programmable keys. 

The state of the Lock Control may be determined from the host 
using the Device Status Report control function. 
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11.3 CONTROL FUNCTIONS 

I REPORT UDK STATUS DSR 


Levels: 2 

Purpose: Report the status of the UDK Lock Control. 


Request Format: 

CSI 

p 

25 

n 


9/11 

3/15 

3/2 

3/5 6/14 

Report Format: 

CSI 

■p 

Ps 

n 


9/11 

3/15 

Ps 

6/14 


Description: The DSR control function (Device Status Report) 

may be used to request the current status of the UDK Lock Control. 
(See the section "Terminal Management" for a complete description 
of Device Status Report.) The terminal will respond to a UDK 
status request (CSI ?, 25 n) by transmitting a Device Status 

Report control sequence containing one of the following selective 
parameters (preceded by the private parameter value ?, 3/15): 

Selective 

Parameter Meaning 


20 The User Defined Keys are not locked, and 

all keys may be defined, cleared, or 
redefined from the host. 

21 The User Defined Keys are locked, and may 

not be defined, cleared, or redefined from 
the host. 

23 No User Defined Keys are present. The 

device does not support this extension. 


Notes: 

1. A report will be given even if the UDK extension is not 
supported. Thus, this request is an optional means of 
determining if the extension is present (the other means 
being the Primary Device Attributes request, as described 
in the section "Terminal Management"). 
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1 State Affected: None 


! Algorithm: 

! PROCEDURE REPORT _ UDK _ STATUS ; 
j BEGIN 

I IF LEVEL 2 EXTENSIONS [UDK] THEN 
I BEGIN 

I CASE UDK. LOCK, CONTROL OF 

I UDK. LOCK. OFF: WRITE ( HOST . PORT <CSI > ?20n ') ; 

! UDk]l0Ck] 0N: WRITE ( HOST. PORT <CSI >?21n ') ; 

i END ; 

j END 

i ELSE WRITE ( HOST. PORT <CSI > ?2 3n ') ; 

I END ; 


Known Deviations: None 
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USER DEFINED KEYS DECUDK 

Levels: 2X 

Purpose: Down line load User Defined Key sequences. 

Format: The DECUDK control is a Device Control String consisting 

of an introducer sequence, followed by a command string. The 
format of the introducer sequence is: 

DCS Pe ; Pi I 

9/0 Pe ; Pi 7/12 

The introducer sequence is terminated by the final character -I 
(7/12) . 


The command string format is: 

Kyi / Stl ; Ky2 / St2 ; ... ; Kyn / Stn ST 

The command string is terminated by the String Terminator 
character 9/13 (in 7-bits, ESC \, or 1/11 5/12). See the section 
"Code Extension Layer" for a complete description of the Device 
Control String format. 


Description: DECUDK control down line loads one or more l<ey 

definitions into the User Defined Keys. This sequence is ignored 
if the UDKs have been locked, either through a previous DECUDK 
sequence or as a local terminal function. This sequence executes 
only when the terminal is in Level 2 operation. 


Notes : 

1. Software should use the UDK function to reclaim key 
definition space in the device. This can be done by 
clearing keys without locking them. Once the keys have 
been cleared the UDK function can be used to redefine the 
keys and lock them. 

2. Host software should not generally leave the user defined 
keys unlocked. This may cause a breach of security to 
the terminal user. 

The host must keep track of space available for key 
definitions. No error indication is given if the 
available buffer space is filled up. 


3 . 
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4. If a key is redefined the old sequence is lost. This may 
free up space if the new sequence is shorter than the 
previous definition. 
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11.3.1 Introducer Sequence Format 

I The following selective parameter values in the introducer 
! sequence may effect the interpretation of the command string. All 

i parameters have the same syntax as a control sequence and may be 
I omitted, in which case the default values are used. 


1. Parameter ( Pe ) : Erase Control 

The first parameter controls which key definitions are to 
be cleared before loading takes place, according to: 

0 - Clear all UDKs before loading new values (default) 

1 - Load new UDK values, clear old only when redefined 

By using Pe=l, it is possible to redefine some keys 
without reloading them all. 

Note that if the clear parameter is set to 1 (load new, 
but don't clear old) it is possible that a key load might 
fail, due to lack of buffer room, even though the final 
total for all keys would have been 256 bytes or less. 

This is because all keys are cleared and loaded 
sequentially. Sequential loading without first clearing 
the ksy definitions could result in intermediate storage 
requirements greater than the maximum provided, even 
though the final requirement would be less than or equal 
to the maximum. For example: If F6 contained 120 bytes, 
F7 contained 110 bytes, and F8 contained 20 bytes, 
loading F8 with 40 bytes, F6 with 1 byte and F7 with 1 
byte works if all UDKs are cleared first, but not if the 
keys are cleared as they are sequentially redefined. 

(When the user attempts to load F8 with 40 ’bytes, the 
load will fail, because only 26 bytes are free at that 
time (256-120-110=26)). 


2. Parameter (Pi): Lock Control 

The second parameter permits the keys to be Ipcked 
against subsequent deletion or re -def ini tion . Locking 
the keys does not effect the definitions included in the 
current DECUDK sequence (unless the keys were previously 
locked), but causes all subsequent DECUDK sequences to be 
ignored (until the lock is cleared by the terminal user 
under local control). The following selective parameters 
may be specified: 

0 - Lock the UDKs against future redefinition (default) 

1 - Don't lock the UDKs against future redefinition 
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Note that Pl=l does not unlock the UDKs, it just does not 
lock them. 

The Final character | (7/12) indicates that this DCS string is the 

DECUDK control function. The data following it up to the String 
Terminator (ST) is from 2/0 through 7/14 and represents the actual 
key loading command. 
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11.3.2 Command String Format 

The syntax of the DECUDK command string is as follows: 

Key definition strings, Kyn/Stn, are included in the data 
following the Final character and before the String Terminator 
(ST). Each Key Definition String consists of a Key Selector 
Number, Kyn, and a String Parameter, Stn, separated by a slash 
"/" • Multiple Key definition strings are separated by semi-colon 

It • tl 
/ 

Bit combinations 0/8 to 0/13 may be included in the command 
string, and have no effect on the interpretation of the data. 

They permit convenient formatting of command strings when being 
created by text editors since TAB, CR, and LF are included in this 
range. The following bit combinations are considered as error 
conditions when they occur within the character font data. Their 
processing is UNDEFINED by the architecture. It is recommended to 
hardware implementors that they be ignored for future 
compatibi 1 i ty . 

o 0/1 through 0/7 

o 0/14 through 2/14 (with the exception of ESC, 1/11 when 
it is followed immediately by \, 5/12, to form the two 
character ESC Fe sequence String Terminator) 

o 3/10 

o 3/12 through 4/0 
o 4/7 through 6/0 

o 6/7 through 15/15 (with the exception of ST, 9/12) 

These characters should not be used by conforming software. 
11.3.2.1 Key Selection Codes 

Key selection codes are specified as string of characters in the 
range 3/0 through 3/9 ("0" through "9")» indicating a single 
decimal value. The values which may be specified in Level 2 are 
the parameter values of the control sequences normally transmitted 
by the programmable keys when they are not pressed in combination 
with the Shift key (CSI ? Pn ~ ) . (See the section "Keyboard 
Processing" for a complete description of the codes transmitted by 
the Application Function Keys.) 

The following table indicates the relationship between the 
specified value and actual keys on the keyboard: 
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Key Selection Code 

Related Key 

17 

F6 

18 

F7 

19 

F8 

20 

.F9 

21 

FIO 

23 

Fll 

24 

F12 

25 

F13 

26 

F14 

28 

Help Key 

29 

Do Key 

31 

F17 

32 

F18 

33 

F19 

34 

F20 


Key selectors may be in any order and may be specified multiple 
times within the string. If multiple definitions of a key occur, 
the last definition is preserved. If no key definition is 
specified for a selected key, that UDK will be cleared of it's 
definition. 

11.3.2.2 String Parameters 

The string parameters, Stn, are the encoded contents of the UDKs . 
They consist of hex pairs in the range 3/0 - 3/9 ("0" through 
"9"), 4/1 - 4/6 ("A" through "F"), and 6/1 - 6/6 ("a" through 
"f"). When these hex values are combined they represent an 8'-bit 
quantity. This allows any of the 256 character codes to be used 
in the UDK sequence. The 8-bit code is loaded high byte first, 
then low byte, as shown below: 

1st hex value 2nd hex value 


-t- H- 

I high nibble i low nibble 1 
I of code I of code ! 

-t- + 



Page 11-15 


VSRM - User Definable Keys Extension EL-00070-011 
*** COMPANY CONF - DEC Internal Use Only . 15-May-1983 


11.3.3 Error Conditions 

The following error conditions may occur, and have the specified 
recovery: 

1. Partial Hex Code - If an odd number of hex values is 
received in any of the string definitions, the current 
key definition and the entire remainder of the load 
sequence will be ignored. The Lock Control will also be 
set (UDK Lock On). 

2. Key Code Out of Range - If a key selection code is 
received which does not represent a programmable key in 
the device, the entire definition for that key will be 
processed and ignored. The remainder of the string will 
be processed normally. 

3. Null Key Definition - If two key definition separators 
(semi-colons) occur together, with no properly terminated 
key selection code intervening, the characters between 
the semi-colons will be ignored. The remainder of the 
string will be processed normally. 
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11.3.4 Algorithm 

NOTE: For the sake of clarity, the following algorithm was coded 

using an excess of UDK buffer memory and working buffers. It 
should be recognized that the memory management schemes which will 
probably be required in many implementations will .make this 
procedure much more complex. 


State Affected: 

UDK: UDK. TYPE; 

TOTAL. COUNT: 0. .MAX. SIZE. UDK. BUFFER; 

UDK . LOCK . CONTROL : ( UDK . LOCK . OFF , UDK . LOCK . ON ) ; 

UDK. BUFFER. OVERFLOW: BOOLEAN; 


Algorithm: 

CONST MIN UDK VALUE =17; 

MAX UDK VALUE = 35; 

MAX. SIZE.UDK. BUFFER = 256; 

TYPE CODE .TYPE = 0..255; 

KEY. DEFINITION. TYPE = RECORD 
CODE BUFFER: 

ARRAY ( 1 . .MAX SIZE. UDK.BUFFER] OF CODE TYPE; 
CODE. COUNT: 0 . .MAX SIZE . UDK BUFFER ; 

END ; 

UDK RANGE = MIN.UDKVALUE..MAX.UDK.VALUE; 

LEGAL. UDK VALUES. TYPE = SET OF UDK. RANGE ; 

UDK TYPE = 

ARRAY [UDK RANGE] OF KEY DEFINITION TYPE; 
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I VAR UDK: UDK.TYPE; 

i TOTAL, CODE. COUNT: 0 . .MAX. SI2E.UDK. BUFFER; 

I UDK. LOCK. CONTROL: ( UDK. LOCK . OFF , UDK . LOCK. ON ) ; 

I LEGAL. UDK. VALUES: LEGAL . UDK . VALUES . TYPE ; 

I LOCK. SET: BOOLEAN; 

i UDK ERASE. CONTROL: ( NO. ERASE .UDK , ERASE .ALL . UDK ) ; 

j VALID. UDK ^SYNTAX: BOOLEAN; 

1 UDK. STRING. TERMINATED: BOOLEAN; 

I KEY'cODE: INTEGER; 

I key] CODE. TERMINATED: BOOLEAN; 

I HEX. CODE. VALUES: SET OF CODE. TYPE; 

I WORK. BUFFER: 

I ARRAY [ 1 . .MAX. SIZE.UDK. BUFFER] OF CODE. TYPE; 

i CODE. PAIR. TERMINATED: BOOLEAN; 

I DEFINITION. TERMINATED: BOOLEAN; 

! UDK. BUFFER. OVERFLOW: BOOLEAN; 

I,N: INTEGER; 

PROCEDURE GET. NEXT EVENT (VAR EVENT: EVENT . BUFFER _ TYPE ) ; EXTERN; 
PROCEDURE GET. UDK PARAMETERS (EVENT: EVENT BUFFER . TYPE ) ; FORWARD; 
PROCEDURE GET. KEY .CODE; FORWARD; 

I PROCEDURE GET. KEY. DEFINITION; FORWARD; 

! PROCEDURE FILL. KEYS; FORWARD; 


! PROCEDURE INITIALIZE . UDKS ; 

i ( * 

! This routine is called on power up reset to initialize 

! the UDK state information to its default values. 

! *) 
i BEGIN 

I (* the following codes are in the specified range, 

I and are the valid programmable key codes for Level 2 *) 
i LEGAL . UDK VALUES := [ 17 . . 21 , 23 . . 26 , 28 . . 29 , 31 . . 35 ] ; 
i (* the following are valid hex codes, 0-9, A-F, and a-f *) 
i HEX CODE. VALUES := [ 48 . . 57 , 65 . . 70 , 97 . . 102 ] ; 

! UDK BUFFER. OVERFLOW: = FALSE; 

TOTAL CODE. COUNT := 0; 

I FOR N:= MIN UDK. VALUE TO MAX. UDK VALUE DO 
i UDK[N] .CODE_COUNT:= 0; 

(* NOTE: The actual value of the Lock Control on 
i initialization is specified by the user in Setup *) 

I UDK LOCK CONTROL := UDK . LOCK . OFF ; 

I END ; 
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1 PROCEDURE EXECUTE UDK (EVENT: EVENT BUFFER TYPE ) ; 

I (* 

I This routine is called each time a DECUDK control 
I string introducer is received. It provides the top 
level control for the key loading sequence. 

I * ) 

I BEGIN 

i GET _ UDK _ PARAMETERS (EVENT); 

I IF VALID. UDK, SYNTAX THEN 
I BEGIN 

I UDK. STRING. TERMINATED := FALSE; 

I IF UDK. LOCK. CONTROL = UDK. LOCK. OFF THEN 

I BEGIN 

I (* clear all udk's if requested *) 

i IF UDK. ERASE. CONTROL = ERASE .ALL . UDK THEN 

I BEGIN 

; FOR N:= MIN UDK VALUE TO MAX UDK VALUE DO 

i UDK[N] .CODE. COUNT := 0; 

: TOTAL. CODE. COUNT := 0 ; 

END ; 

(* then process the command string *) 

I FILL. KEYS; 

I END ; 

I ( * if locked or overflowed, keep going until the end *) 

i WHILE NOT UDK STRING. TERMINATED DO 

! BEGIN 

! GET. NEXT. EVENT (EVENT); 

IF (EVENT. EVENT. CODE = CONTROL . CODE ) 
j AND ( EVENT. CODE VALUE = 156) THEN 

i UDK STRING. TERMINATED := TRUE ; 

I END ; 

i END; 

! (* set the lock if requested *) 

j IF LOCK. SET THEN UDK . LOCK CONTROL : = UDK LOCK ON; 

END ; 


PROCEDURE GET UDK PARAMETERS; 

I (* get all of the parameters for the load *) 
BEGIN 

I VALID UDK SYNTAX := TRUE ; 

i CASE EVENT . PARAMETERS [ 1 ] OF 

1 0: UDK. ERASE. CONTROL := ERASE. ALL UDK; 

I 1: UDK ERASE. CONTROL := NO . ERASE . UDK ; 

j OTHERWISE VALID UDK. SYNTAX := FALSE; 

! END ; 

I CASE EVENT.PARAMETERS[,2 ] OF 
i 0: LOCK. SET := TRUE; ■ 

I 1: LOCK. SET := FALSE; 

I OTHERWISE VALID UDK SYNTAX := FALSE; 

END; 

END ; 
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PROCEDURE FILL KEYS ; 

(* 

This routine processes the command string and loads the 
key definition strings into the appropriate key buffers. 

*) 

BEGIN 

UDK_ STRING, TERMINATED ;= FALSE; 

(* get all of the key definitions in the strings *) 

REPEAT 

KEY . CODE . TERMINATED : * FALSE ; 

DEFiNITl6N_TERMINATED:= FALSE; 

GET. KEY, CODE; 

IF KEY. CODE, TERMINATED THEN 
BEGIN 

(* fill work buffer with code string *) 

GET, KEY, DEFINITION ; 

(* ignore out of range key codes *) 

IF (KEY CODE IN LEGAL , UDK , VALUES ) 

AND ( CODE, PAIR, TERMINATED) THEN 
BEGIN 

IF TOTAL CODE, COUNT -H I <= MAX , S I ZE _ UDK , BUFFER THEN 
BEGIN 

UDK[ KEY, CODE] . CODE , BUFFER : = WORK. BUFFER; 

TOTAL . CODE , COUNT : = 

TOTAL, CODE, COUNT - UDK [ KEY , CODE ]. CODE , COUNT ; 

UDK [ KEY _ CODE ] . CODE , COUNT :=I; 

TOTAL CODE, COUNT := TOTAL, CODE COUNT -(- I; 

END 

ELSE UDK BUFFER OVERFLOW := TRUE ; 

END 

ELSE IGNORE; 

END; 

(* these conditions cause the rest of the string to be ignored *) 
UNTIL (NOT CODE PAIR, TERMINATED) OR ( UDK , BUFFER _ OVERFLOW ) 

OR (UDK STRING TERMINATED ) ; 

END; 
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PROCEDURE GET KEY CODE; 

{* 

This routine parses a single key selector code 
from the command string. 

*) 

BEGIN 

KEY.CODE;= 0; 

REPEAT 

GET , NEXT , EVENT ( EVENT ) ; 

CASE EVENT. EVENT. CODE OF 
GRAPHIC. CODE: 

begin" 

IF ( EVENT. CODE. VALUE >= 48) 

AND ( EVENT. CODE. VALUE <= 57) THEN 

KEY.CODE:= (KEY. CODE * 10) + ( EVENT . CODE . VALUE - 48) 

ELSE 

BEGIN 

CASE EVENT. CODE VALUE OF 

47: KEY CODE TERMINATED := TRUE; 

59: DEFINITION_TERMINATED:= TRUE ; 

OTHERWISE IGNORE; 

END; 

END; 

, END ; . 

CONTROL CODE: (* terminate on String Terminator, 9/12 *) 

IF EVENT. CODE. VALUE = 156 THEN UDK _ STRING . TERMINATED : = TRUE 
ELSE IGNORE; (* ignore other control characters *) 
OTHERWISE IGNORE; (* ignore escape and control sequences *) 
END ; 

UNTIL ( KEY CODE. TERMINATED) OR (DEFINITION TERMINATED) 

OR (UDK STRING. TERMINATED ) ; 

END ; 
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PROCEDURE GET KEY DEFINITION; 

(* 

This routine parses a single key definition string from the 
command string. 

*) 

BEGIN 
I : = 0 ; 

CODE. PAIR _ TERMINATED := TRUE; 

REPEAT 

GET. NEXT. EVENT (EVENT); 

CASE EVENT. EVENT. CODE OF 
GRAPHIC. CODE; 

BEGIN 

IF EVENT. CODE. VALUE IN HEX. CODE .VALUES THEN 
BEGIN 

(* convert ascii codes to hex values *) 

EVENT. CODE. VALUE := EVENT. CODE VALUE - 48; 

IF EVENT. CODE .VALUE >=65 THEN 

EVENT. CODE VALUE := EVENT. CODE VALUE - 7 ; 

IF EVENT. CODE. VALUE >= 97 THEN 

EVENT. CODE. VALUE := EVENT . CODE . VALUE - 22; 

(* then pack into buffer *) 

IF CODE. PAIR. TERMINATED THEN 
BEGIN 
I:= I+l; 

WORK BUFFER! I ] := 0; 

CODE PAIR. TERMINATED := FALSE; 

END 

ELSE CODE. PAIR TERMINATED := TRUE ; 

WORK. BUFFER! I ] := 

{ (WORK BUFFER! I ] ) * 16 ) + EVENT. CODE VALUE; 

END; 

IF EVENT. CODE. VALUE =59 THEN 
DEFINITION TERMINATED:= TRUE ; 

END ; 

CONTROL CODE: (* terminate on String Terminator, 9/12 *) 

IF EVENT. CODE. VALUE = 156 THEN UDK STRING . TERMINATED : = TRUE 
ELSE IGNORE; (* ignore other control characters *) 

OTHERWISE IGNORE; (* ignore escape and control sequences *) 
END; 

UNTIL (DEFINITION TERMINATED) OR ( UDK STRING TERMINATED ) ; 

END ; 
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11.4 UDK KEY DEFINITION EXAMPLES 

To clear the UDKs send the following sequence; 

DCS 0 ; 1 I ST 

To lock the UDKs send the following sequence: 

DCS 1 ; 0 I ST 

The following is a generalized example of the recommended way to 
load the UDKs: 

DCS 0 ; 1 I Kyi / Stl ; Ky2 / St2 ; ... ; Kyn / Stn ST 
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11.5 CHANGE HISTORY 
11.5.1 Revision 0.0 To AXIO 


The spec was entirely rewritten from the original 
draft. The following sections were added: 

1. Introduction 

2. Functional Description 

3. Report UDK Status (control function) 

4. Extensively modified the UDK load sequence, DECUDK 

5. Pascal coded algorithms 

6. UDK load examples 
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1 INTRODUCTION 

This document describes S 3 mchronization mechanisms for software which interfaces 
computers to terminal devices. These mechanisms are used for flow control to prevent 
devices from losing data received faster than it can be processed; to S3mchronize keyboard 
and display processing in terminals with software running on remote hosts; and to reset 
or initialize the communications context. Currently these mechanisms are defined for use 
over serial asynchronous communications lines, and include XON/XOFF flow control and 
Break. 

XON/XOFF flow control is a means of using control characters DCl (XON) and DC3 
(XOFF) to alternately suspend and resume the flow of characters over serial as 3 oichronous 
communication lines. 

Break is an out of band signal frequently used to reset the communications environment or 
data interchange context over serial asynchronous lines. The Break condition is defined as 
a continuous space (transmission line held in its zero state) for longer than one character 
time. Although there is no standard use for Break, Digital terminals allow the Break 
signal to be generated under user control. 

1.1 SCOPE 

This standard applies to all Digital products which implement XON/XOFF flow control, 
all products which are intended to be certified as conforming to the Terminal Interface 
Architecture, and software which is intended to use tmminal interfaces in a conforming 
manner. 


1.2 RELATIONSHIP TO TIA 

XON/XOFF flow control and break are part of the external communications interface that 
lies below the code extension layer. Flow control and break are management functions 
that control the communications link. No conforming applications should depend on the 
presence of^ or performance characteristics of terminal synchronization. 

2 XON/XOFF FLOW CONTROL 
2.1 PROTOCOL 

XON/XOFF flow control is a means of using CO control characters DCl (1/1) (XON) and 
DCS (1/3) (XOFF) to alternately suspend and resume the flow of characters over serial 
asynchronous point to point communication lines. Flow control is xised to avoid losing 
data when a sending device is capable of transmitting data faster than the correspondii^ 
receiving device can process or use it. 

XON/XOFF flow control is only applicable to full duplex communication lines with a 
specified minimum amount of receive data buffering. The exact buffer requirements depend 
on the maximum transmission rate and response time of the sender and receiver. 

XONXOFF flow control is a symmetric protocol and may be used independently in either 
or both directions. Only one direction is described below for simplicity. Most systems will 
conform as both a sending device and a receiving device. Product documentation shoiild 
state clearly if an implementation intends to only conform as a sending device or receiving 
device. 
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Sending Receiving 

Device (SD) Device (RD) 


SDTX 


flow controlled 

W 

RDRX 


A 


SDRX 


(XON/XOFF) 


RDTX 


When XON/XOFF flow control is enabled between a sending device and a receiving device, 
XON and XOFF characters received at the sendii^ device (SDBX) are interpreted as flow 
control and are not stored in the sending device’s input buffer. Because th^ are used for 
flow control, characters XON and XOFF may not be passed as part of the normal data 
interchange from the receivii^ device to the sending device. 

The sending device recognizes XOFF (1/3) as a request from the receiving device to 
suspend the transmission of characters. When this character is received by the sending 
device, transmission of all characters (other than XON or XOFF) to the receivii^ device is 
suspended. When the sending device’s communication port is in this state, it is said to be 
in the XOFF state. If the device is already in the XOFF state when an XOFF character is 
received, this character is ignored. 

The sending device recognizes XON (1/1) as permission from the receiviz^ device to resume 
the transmission of charactm:*s, if any. When this character is received by the sending 
device, the XOFF state of the device’s communication port is cleared and transmission 
of characters in the communication port output buffer is resumed. If the device was not 
XOFF-ed, this character is ignored. 

Receiving Device Input Buffer (FIFO) 


— rx-data — > 


t t t t 

XON first second buffer 

point XOFF XOFF full 



The receiving device transmits XOFF to the sending device if a character other than XON 
or XOFF that would be stored in the input buffer is received from that device, and (1) the 
number of characters in the input buffer reaches the first XOFF point for the first time 
since the last XON was sent; (2) the number of characters in the input buffer reaches the 
second XOFF point for the first time since the last XON was sent; or (3) the input buffer 
is full. If the input buffer is full, the received character is discarded. An error indication 
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should be made iu the receiving device if characters are discarded (not mandatory). A 
terminal might display the error character for example. 

If the sending device can respond to XOFF fast enougd^ to avoid buffer overflow from 
the second XOFF point, reliabilily is improved on systems where the first XOFF might 
be lost during transmission. Support for the second XOFF point is not mandatory, but 
recommended for use over noisy communication channels. 

The reason to send an XOFF for each character that arrives while the input buffer is full 
is to insure that the sending device will receive an XOFF even if it is reset (clearing the 
XOFF state) after the input buffer was filled. Transmission of XOFF for each character 
received while the input buffer is fiill is not mandatory. 

The receiving device transmits an XON to the sending device when the receiving device’s 
input buftOT empties to the XON point, and the last flow control sent by the receiving device 
was XOFF. This XON must not be blocked by any data being held in the receiving device’s 
transmit queue. If both devices had transmit queues and did not allow XON characters to 
b3rpass them, they cotild become locked in a "deadly embrace". Special provision shall be 
made to send XON promptly regardless of the XON/XOFF state of the receivii^ device. 

Z2 XON AND XOFF POINTS 

2.2.1 Requirements 

The choice of XON and XOFF points will depend on the receive buffer size and the 
performance characteristics desired. The following requirements apply to the selection of 
XON and XOFF points. In all cases, the first XOFF point must be hi^er (closer to bufter 
fuU) than the XON point. 

Terminals shall provide at least 32 characters of recmve bufter space beyond each XOFF 
point supported (the bufter full condition is not considered an XOFF point). 

When an XOFF point is reached, the receiving device should transmit XOFF as soon as 
possible to maximize the response time available to the sender. It is anticipated that some 
hardware devices will employ a transmit output bufter and will not be able to insert XOFF 
into the output stream immediately. In the worst case, XOFF shall be transmitted within 
five diaracter times from when the XOFF i>oint was reached. 

Some implemmitations allow the first XOFF point to be selected under local control to 
limit the number of characters ahead of the screen the host can transmit. For interactive 
terminals with large input biifters, it shall be possible to set the first XOFF point to 64 
characters or less (in the receive input bufter). 

2.2.2 Guidelines and Examples 

The dioice of XON and XOFF points is comphcated because there are several competing 
objectives that can be optimized. XON and XOFF points shotild be chosen to provide a 
reasonable compromise between these objectives for the intended use of the device. For 
some devices it may be desirable to make the XON and XOFF points user configurable. 

To increase the amount of response time available to accomodate end to end signaling 
delays (satellite relay of telephone signals can take hundreds of milliseconds for example), 
it is desirable to provide lots of receive bufter space after the first XOFF point. 
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lb allow a sender to finish a printing task as early as possible, it is desirable to make the 
XON point high (closer to buffer full). 

To reduce the amount of XON/XOFF traffic and/or the number of data transfers, it is 
desirable to have the XON and (first) XOFF point far apart. 

To mazunize throughput, it is desirable to balance the XON response time (before the 
receive input buffer empties) with the XOFF response time so the receiver does not sit idle 
waiting for the slider to respond to XON. 

For interactive video terminals that provide 32 characters of input buffm* space beyond the 
last XOFF point, Ihe XON point will normally be at 32 characters, or at half the number of 
characters to the first XOFF point, vdiichever is less. 

EXAMPLES 

The VnOO provides a 64-character recmve input buffer with the first XOFF point 
at 32 characters, no second XOFF point, and XON point at 16 characters. 

The 'VT220 provides a 254-character receive input buffer with the first XOFF point 
selectable to 64 or 128 characters. The second XOFF point is 220 characters. The 
XON iKiint is 32 characters. 

The VnOO and 'VT220 are des^ned to provide 32 characters of input buffer space 
to respond to XOFF (from the XOFF point to buffer full on the VTIOO, and from the 
second XOFF point to buffer full on the 'VT220). 

2.3 RECEIVE BUFFER SIZE 

Terminals shall provide at least 64 characters of receive input buffer space, with at least 
32 characters of input buffer space be 3 ond each XOFF point supported. 

Although AvifltiTig Digital Terminals respond to XOFF within two character times, other 
recmving devices (indudii^ host computers) should provide at least 32 characters of input 
buffer space beyond the XOFF point to be symmetric with the VTIOO and Vl^OO terminal 
families (not mandatory). This is desirable to support PCs and Workstations running 
tCTminal emulator software. 

In an cases, the recmve input buffer size and XOFF point must be sufficient to prevent 
buffer overflow undm: the intended operating conditions. 

2.4 BUFFER OVERFLOW PREVENTION 

In order to prevent buffer overflow, the sending device must respond to an XOFF within 
some maximum amount of time vdiich depends on the size of the receiver’s input buffer, its 
XOFF point, and the transmission rate. 
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2.4.1 Number of Characters to Buffer Overflow 

When the sending and receiving transmission rate are the same, the maximum guaranteed 
number of characters before btiffer overflow assuming immediate response is: 


OVFL - (MXBF - XOPP) - 3 
Where: 

OVFL » the nimber of characters before overflow 
MXBF » the receive buffer size 
XOFF * the XOFF point 

The constant ’3’ derives from the following possible character dela}^: (1) When the receive 
buffer reaches the XOFF point, the receiving device may be in the middle of sending a 
character and unable to send XOFF until the character finishes; (2) It takes one character 
time to transmit the XOFF; (3) Assuming the transmittix^ device can respond immediately 
to the XOFF, it must still finish the character it is currently sending (if any). 

Situations that may reduce the number of characters before buffer overflow include: 

1. Systems that support different transmit and receive speeds (the slower channel cannot 
send or receive the XOFF as fast OVFL = (MXBF-XOFF) - [3(RCDR/XMDR)] ). 

2. Systems that utilize transmit output buffers and caxmot insert XOFF into the output 
stream immediately. 

3. Systems that employ "transmit rate limiting" to limit the number of characters per 
second below the maximum allowed by the baud rate. 

DEVIATION NOTE 

The number of charactm*s before buffer overflow on the VT220, and VTSOO family 
is calctilated differently because received characters are only handled dtuing V 
Blank time. The actual formula is: 

OVFL « (MXBF-XOFF) - [3 (RCDR/XMDR) 3- (RCDR/600) 

The last term takes into account the worst case for when the received character 
would get serviced. 

The VlitgO and VTSOO series will not ccmsistently transmit XOFF within five 
character times of reaching an XOFF point (but they still provide more than 32 
characters of buffer space firom when the first XOFF is sent). This delay until V 
Blank time should be discouraged in future devices. 


dig it a 
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2.4.2 Response Time to XOFF 

The TwairiTtinTn response time available to the sending device to stop sending (in order to 
guarantee that the buffer will not overflow) is the time it takes to transmit the number of 
characters until buffer overflow (OVFL). 


MRST - OVFL X [ (DATA + STOP + PRTY + 1)/XMDR] 


where : 


MRST 

OVFL 

DATA 

STOP 

PRTY 

' 1 ' 

XMDR 


xnaxixmim response time 

the number of characters before overflow 
the number of data bits per character 
the number of stop bits per character 
the number of parity bits per character 
the start bit 

the transmit data rate (bits per second) 


It is recommended (but not mandatory) that the sendii^ device stop transmitting 
immediately upon receipt of an XOFF (after the current character). 

XON/XOFF flow control is intended for use over point to point full duplex links. The time 
available to respond to XOFF will be reduced by any end to end signaling delays. 


2.4.3 Response Time Example 

If the sending device is a host computer intended to work with a VTIOO at 9600 bits per 
second, the TnaviTniiTw response time can be computed as follows: 

OVFL - (MXBF - XOFF) - 3 
- (64 - 32) - 3 

» 29 characters until overflow 

Assuming 8>bit characters with no parity and one stop bit: 


MRST - OVFL X [ (DATA + STOP + PRTY + 1)/XMDR] 

-29 x[(8 +1 +0 + l)/9600] 

V 0.030 seconds 

For this example, the sending device indudiz^ transmission delays in either direction must 
respond to XOFF within 30 miUiseconds to avoid buffer overflow. 

2.5 INITIAUZATION 

When a device flrst powers on, it has no way of knowiz^ the XON/XOFF state of a 
communication link. Devices shall send a single XON at power-up vdien they are ready to 
receive data, and assume their transmitter is in the XON state. 

Devices that can be locally controlled (that is, have some form of k^board or local control 
panel) shall provide a means for the operator to re-initialize the XON/XOFF state. This 
"Clear Communications" function will include the following actions: (1) clear the device’s 
transmit queue; (2) clear the XOFF state of the device’s communication port; (3) transmit a 
single XON to the remote device. 
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GUIDELINE 

The VTIOO sends XON at power-up, and allows the XON^OFF state to be 
re-initialized by entering and «dting Set-Up. 

The 'VT220 sends XON at power-ai>. A "Clear Conun" function is provided in Set-Up 
to re-initialize the XON^OFF state. 

2.6 OTHER EVENTS THAT AFFECT XON/XOFF STATE 
2.6.1 Special Characters 

Some devices interpret other characters besides XON to mean "okay to resume 
transmission". These characters are not synon 3 rmous with XON and shall be treated as 
special conditions that re-initialize the XON/XOFF state. It is up to the device receiving 
data to decide what, if any, special characters will clear its XOFF state. A device sending 
data shall not assume any characters other than XON will dear the XOFF state of the 
receiving device. 

GUIDELINE 

Some operating systems have interpreted CTRL/Y and CTRL/C as events that 
re-initialize the XON/XOFF state. Upon receipt of CTRL/Y (when CTRL/Y handling 
is enabled), VMS clears the communication port's output queue, clears the XOFF 
state of the communication port, and transmits an XON to the tmrminal. Terminals 
dmuld not assume, however, that sending CTRI/Y will clear the XOFF state of 
the remote device, and should not re-initialize their own XON/SOFF state upon 
sending CTRL/Y 

2.6J2 Local Events (Guidelines) 

Some devices generate XON or XOFF flow con^l as a result of local events which affect 
the processing of incoming data. 

The VTIOO sends XOFF when entering Set-Up, and sends XON upon exit from Set-Up. 
The VT220 enters the hold screen state (if not already held) when entering Set-Up, and 
leaves the hold screen state if not previously held upon a-iritiTig Set-Up. 

The LN03 sends XOFF when the paper cover is lifted and sends XON when the paper 
cover is replaced. It is suggested that printers send XOFF when th^ are unable to process 
incoming data (including going off-line), and send XON when they are again ready to 
process incoming data (including going on-line). 

2.7 RESERVED CHARACTERS 

DCl (1/1) (XON) and DCS (1/3) (XOFF) are to be used for synchronization in the manner 
described in this standard. DC2 (1/2) and DC4 (1/4) are reserved for future use, likely for 
synchronization. These characters should not be used to convey meaning to application 
software. 
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Z8 TERMINAL KEYBOARD SYNCHRONIZATION 

When XON/XOFF flow control is enabled, terminals may be XOFF-ed to suspend 
transmission of characters to the host. Terminals -will maintain a silo for keyboard output. 
In the event that the keyboard produces characters faster than they can be sent, the silo 
will buffm: at least nine keystrokes. For the purpose of buffering, a compose sequence or 
function key counts as one keystroke. If the sUo becomes full, keystrokes may be discarded. 
Terminals shall provide some indication that the silo is fiiU and/or keystrokes are being 
discarded. 

guideline 

ha the VT200 family, ihe Wait LED comes on when the keyboard silo is full, and 
the keyboard stops clicking (if keyclick was miabled) whmi ke 3 rstrokes are being 
ignored. 

2.9 TERMINAL SCREEN SYNCHRONIZATION (HOLD SCREEN) 

When XON/XOFF flow control is enabled, terminals shall allow the data on the screen to 
be held for easy reading (stop scrolling) even though data is still being received from the 
host computer. The 'Hold Screen" flmction is a toggle that switches the terminal screen 
between the HELD and NOT.HELD states. The Hold Screen flmction does not transmit 
XON or XOFF, but may cause the terminal’s input buffer to fill when the screen is in the 
HELD state, and empty again when the screen is returned to the NOT.HELD state. 

When XON/XOFF flow control is enabled, typing CTRL/S (XOFF) or CTRL/Q (XON) at 
the keyboard will not transmit codes to the host computer. Instead, these keystrokes will 
toggle the hold screen state between HELD and NOT.HELD respectively. 

When XON/XOFF flow control is disabled, the Hold Screen function does not operate and 
typing CTRL/S (XOFF) or CTRL/Q (XON) at the keyboard will transmit the corresponding 
codes to the host computer. 

2.10 EMERGENCY MESSAGES 

At times, one device may need to seiad another a h^h-priority or emergency message. If 
the intended receiver has sent an XOFF however, it has indicated that it is not ready to 
recmve more data. This may be because the receiver is literally unable to receive or process 
a message (a printing terminal with a blown fuse, for example), or it may just be that the 
operator has activated the Hold Screen function. 

At the time of this update to the standard, there is no clear consensus on how to bandU 
em^gency messages. 

DEVIATION NOTE 

Some printers respmd to device status inquiries immediately even whmi tiiey are 
in the XOFF state (using the XOFF state as a control channel)^ This mechanism 
should be used only by explicit, device depmidmtt agreement between the printer 
and supporting host. It is not part of the XON/XOFF protocoL and may not be 
supiiorted in future devices. 
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2.11 IMPUED XOFF RULE 

Certain terminal functions durii^ which the terminal is tmable to respond to host data use 
an implied XOFF rule. The implied XOFF rule allows the host to suspend transmission 
until the terminal is again able to respond. When a host computer invokes one of these 
hmctions, it is to enter the XOFF state as if an XOFF had been received hrom the terminal 
(implied XOFF). Upon completing the requested fiinction, the terminal must send an XON 
to reenable host transmission. 

Currently, only RIS (Reset to Initial State) and DECTTST (DEC Test) use the implied XOFF 
rule. These functions are intended for diagnostics and shall not be used by conforming 
application software. Under normal operation, terminal devices should not stop monitoring 
the communication line, or should send XOFF before going "off line". 

3 BREAK 

Break is an out of band signal frequently used to reset the communications environment or 
data interchange context over serial asynchronous hues. The Break condition is defined as 
a continuous space (transmission line held in its zero state) for longer than one character 
time. See DEC STD 52 for additional information on physical generation of the break 
signal. Although there is no standard use for Break, Digital terminals allow the Break 
signal to be generated under user control. 

The remainder of this section describes how the Break signal is transmitted, when it may 
be transmitted, and operation of the break key. 

3.1 THE BREAK SIGNAL 

Althoi:^^ Break is defined as a continuous space exceediz^ one character time, the duration 
of the Break signal generated by Digital terminals has been standardized for reliability. 
The Break signal will hold the transmission line to its zero state for 275 milliseconds (plus 
or minus 25 ms). 

3.1.1 Long Break Disconnect 

Some modems use a longer Break of 3.5 seconds to signal a remote data set to disconnect 
from the communications line. When xzsed, this signal is generated by the modem. 
Terminals indicate discoimect to a modem using the DTK modem control signaL There is 
no known reason for a terminal to generate the 3.5 second loi^ Break. 

GUIDJEILEHE 

The VT220 and newer tmninals do not generate the loi^ break signaL On 
the VTIOO, pressing SHIFT/BKEAE would generate a long break in addition to 
droppii^ I)TB. 

3.2 WHEN BREAK MAY BE TRANSMITTED 

A Break signal may be transmitted by terminals only upon activation of the break key. 
Break shall never be transmitted during power>up, power-down, self-test, or terminal reset 
operations. 
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Previous terminals (VTIOO, ^220) have transmitted Bi^ak during power-up, and self-test. 
This use of Break should be eliminated for the following reasons: 

• It does not conform to DEC STD 052-1 which requires TXD (transmit data) be held in 
the mark state durii^ power-up. 

• Break is used by some Digital S3nstems to halt the console CPU. Transmittii^ Break at 
power-up is inappropriate for these systems. 

• Sending Break during self-test precludes the use of remote diagnostics. If a host 
requests a terminal self-test, the resulting Break may cause a disconnect. 

3.3 OPERATION OF THE BREAK KEY 

When the break key is activated, special provision shall be made to transmit a Break 
signal immediately regardless of keyboard locking (EAM), XON/XOFF flow control, or the 
state of the keyboard input silo. If a character is currently being transmitted, the Break 
signal will begin as soon as the stop bit of the current character has completed to avoid 
loss of data. Activating the break k^ does not clear the keyboard input silo, reset EAM, 
or change the XON/XOFF flow control state. 

3.4 RECEIPT OF BREAK 

Terminals shall detect break esplicitly and do nothing at all when break is received at the 
host communication port. 
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APPENDIX A REFERENCED DOCUMENTS 


A.1 EL-Class Digital Documents 

EL-Class Number 

Document Title 

EL-00052-00 

DEC STD 052-0 Operational Requirements for Serial Terminals and Computer 
interfaces Operating as DTEs Connected to EIA RS-232-C or CCITT V,2d Modems 

EL-00052-01 

DEC STD 052-1 Operational Requirements for Serial Data Terminal Equipment and 
Serial System Interfaces Operating as DTEs Connected to EIA RS-232-C or CCITT 
V28 Point-To-Point Modems or Data Service Units 


Use VTX SMC to order copies of EL-class documents &om Standards and Methods ControL 
Send distribution questions to JOKUR::SMC or call DTN: 287-3724. 
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1 INTRODUCTION 

This specification defines support for locator or pointing devices on ANSI text and graphic 
terminals as an extension to the Character Cell Display service class. Pointing devices are 
used for entering coordinates or selecting items on a display. 

A conforming device shall be supplied with a locator port used to connect an optional mouse 
or tablet. When a locator device is present and enabled, a separate input cursor appears 
that is moved by the terminal to follow the locator without host intervention. Individual 
locator events, such as locator button transitions or movements, can be programmed to 
send locator reports to the host. 

Once enabled, locator reports can be unsolicited (event driven) and mixed freely with 
keyboard input. 

Controls are provided to enable locator reporting, select which events shall generate 
reports, and interrogate the status of the locator device. 

This specification is primarily concerned with the Text Locator Extension, but also 
documents a simplified locator interface that forms the Locator Port Extension. 
Requirements apply to the Text Locator Extension unless explicitly indicated in the text. 

1.1 SCOPE 

This standard applies to all Digital products that implement support for a locator device 
and are intended to be certified as conforming to the Terminal Interface Architecture (TIA) 
as shown in Figure 1. It also applies to software intended to use the locator interface in a 
conforming manner. 

1.2 Relationship to TIA 

The locator interface forms two extensions to the Character Cell Display service class: 
Text Locator and Locator Port. Both can be implemented at any conformance level. The 
primary Device Attributes (DA) response will report the locator extensions as parameter 
value 15 (Locator Port), and parameter value 29 (Text Locator). The Locator Port Extension 
supports DECLKD. If the device includes tiie ReGIS or sixel graphics extensions, additional 
interactions with these protocols are defined. The Text Locator Extension supports the 
text locator features described in this document (DECELR, DECLRP, DECRQLP, DECSLE, 
DECEFR). Both extensions allow the status of the locator port to be interrogated using a 
Device Status Report (DSR) function. 
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Figure 1 : Structuring of the Terminai Interface Architecture 


USER 



APPLICATION PROCESS 


The interfaces defined within this specification apply to both internal emd external product 
interfaces (as shown in Figure 2). External interfaces are interfaces between a termiaal, 
personal computer or workstation and a remote system. Internal interfaces are interfaces 
between a terminal subsystem and software processes running within a terminal, personal 
computer, or workstation. 

Figure 2: Externai and internai Terminai Interfaces 
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2 TERMINOLOGY 

Filter rectangle— A rectangular area in a video display used for selecting (filtering) which 
locator movements will be reported to the host. Moving the locator so that the input cursor 
is moved outside the filter rectangle causes a locator report to be transmitted to the host. 

Locator — A device such as a mouse or tablet used for entering position coordinates 
(pointing) on a video display. 

Session — A connection between a single virtual terminal and a host computer. 

Virtual terminal — Consists of all the context (state information) of a real terminal but is 
able to share physical resources (such as the keyboard, display, and communication lines) 
with other virtual terminals. This allows a single physical device to appear as more than 
one terminal to a host computer. 

Window — An area of the screen used to display information from a virtual terminal. 
Window manager — Software or firmware that controls the use of windows. 

3 LOCATOR REPORTING MODEL 

When a locator device is present and enabled, a separate input cursor appears that is 
moved by the terminal to follow the locator without host intervention. Individual locator 
events such as locator button transitions or movement can be programmed to send locator 
reports to the host. 

Each locator report shall include: (1) the specific event that initiated the report; (2) the 
current state of the locator ke3rs; and (3) the coordinates of the input cursor at the time 
of the event. The events that can initiate a locator report are a button transition (up or 
down), locator movement, or an explicit host request. 

Reporting both the event that triggered the report, and the current button state allows 
software to interpret locator activity without keeping track of previous events or button 
state. In a multiprocess shared locator environment, an application may not know the 
previous button state. This dual reporting also allows applications to recover from lost 
locator reports. 

Each locator event generates a single report. In the rare situation where two events occur 
simultaneously (within a single-sampling period), the terminal shall report this as two 
separate events. The order of reporting shall be by increasing event code number (left 
button first). 

Locator events are queued in the keyboard input silo just like keystrokes. Each locator 
event occupies one position in the silo (the keyboard silo currently must have at least nine 
positions). If the input silo becomes full, the locator and keyboard are locked until there 
is again room in the silo. The sequential order of keystroke and locator events shall be 
strictly maintained. 

Guideline: It is the responsibility of the host to accept data fast enough to avoid locking 
the locator unintentionally. The limited buffering inside the terminal gives the host a little 
more time to process locator events smoothly. 
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When the locator is locked, the terminal continues to track the locator but the input ciirsor 
changes shape to indicate the locked condition (not mandatory). The alternate cursor shape 
indicates that locator button transitions will be ignored, but allows the user to continue 
positioning in anticipation of the locator being unlocked. The locator is automatically 
locked any time the input silo is full. 

Locator-ahead, analogous to keyboard type-ahead is supported by having each report 
include the locator position at the time of tiie event, and maintaining the sequential order 
of keystroke and locator events. 

3.1 INTERACTION WITH SESSIONS AND WINDOWS 

Since locator events are queued in the keyboard input silo along with keystrokes, locator 
and keyboard input should be associated with the same session (virtual terminal) at all 
times. The session to receive these events is sometimes called the active session. 

In a multisession windowing environment, the input cursor is allowed to roam freely over 
the entire screen in response to locator movement. The input cursor is never occluded 
when locator reporting is enabled in one or more sessions. Each session enables locator 
reporting independently. The following requirements apply to locator interaction with 
session windows and scroll regions in a multisession windowing environment. 

1. The input cursor is within the active session’s window. Pressing a button on the locator 
sends a locator report when enabled. 

2. The input cursor is inside the active session’s window but outside the range of defined 
coordinates for that session. Pressing a button on the locator shall generate a report 
with omitted coordinates (position undefined). For example, the input cursor is outside 
the active scrolling region, and the origin mode is set to relative. 

3. The input cursor is not contained in any virtual terminal’s window. Pressing a button 
on the locator shall have no effect on any of the virtual termmals. 

4. The input cursor is within a window of a session that is not the active session. Pressing 
a button on the locator will normally make the session containing the locator cursor 
the active session, possibly changing the occlusion order of windows and the shape of 
the locator cursor (not mandatory). 

In this case, the window manager is free to define its own user interface. Two 
recommendations (not mandatory) are: (1) no locator report should be sent to the 
previous active session, because the locator is not in its window; and (2) a locator 
report should not be transmitted if locator reporting is enabled in the new session, to 
avoid application side effects when selecting another window. 

Implemeiiiation Guideline: DECterm Version 1.0 followed recommendation (1) 
above, but did not follow recommendation (2). The result is that selecting a new 
DECterm window often repositions the cursor m that window. Personal computer 
windowing systems usually require the user to click once to select the window and 
click again in the window to move the active position. 
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4 CONTROLLING LOCATOR REPORTS 

ENABLE LOCATOR REPORTS DECELR 


Levels: lx, 2x, 3x, 4x (Text Locator) 

Purpose: To enable locator reporting 
Format: 

CSI Ps ; Pu ' z 

9/11 3 /? 3/11 3 /? 2/7 7/10 


The value of Ps controls locator reporting as follows: 

0 — ^Locator disabled (default) 

1 — ^Locator reports enabled 

2 — One shot (allow one rei>ort, then disable) 


Pu specifies the coordinate units for locator reports: 

0 — (or omitted) Default to character cells 

1 — ^Device physical pixels 

2 — Character cells 

Description: When disabled (the power-up default), the locator cursor does not appear, 
and the locator buttons are inactive. When enabled, the locator cursor is visible, and the 
terminal tracks the locator locally witii no host intervention. Individual locator events, 
such as locator button transitions or movements, may be programmed to send locator 
reports to the host. 

One shot mode is provided for applications that desire simple graphics input similar to 
Tektronix GIN mode (no unsolicited reports). If parameter value 2 is selected, the next 
trigger event that occurs generates a single locator report. No further locator reports occur 
(the locator is disabled), until another DECELR sequence is received. 

The coordinate units for locator position reports may be selected to either of two coordinate 
systems used by terminal software at the lowest level. Device physical pixels are useful 
when the device is capable of addressing individual dots on the display, such as with the 
sixel graphics extension. On devices that support character cell addressing only, device 
physical pixels (picture elements) may be character cells. 

NOTE 

Und^ned values for Ps or Pu causes the entire sequence to be ignored. 

State Affected: 

locator_mode_t locator_mode; 

locator_coordinate_mode_t locator_coordinate_mode; 
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LOCATOR REPORT DECLRP 


Levels: lx, 2x, 3x, 4s. (Text Locator) 

Purpose: To transmit locator information to the host 

Format: 

CSI Pe ; Pb ; Pr ; Po ; Pp & w 

9/11 2/6 7/7 

Pe is the event code. 

Pb is the button code. 

Pr is the row coordinate. 

Pc is tibe column coordinate. 

Pp is the third coordinate (page number). 

Description: When a selected trigger event occurs, such as a button press or release, the 
terminal transmits a locator report to the host as a DECLRP sequence. 

Pe, the event code indicates what event caused this report to be generated. The following 
event codes are defined: 

0— Request; the terminal received an explicit request for a locator report, but the locator 
is unavailable (not enabled, or physically not present) 

1 — ^Request; the terminal received an explicit request for a locator report 
2r — ^Left button down 

3 — ^Left button up 

4 — ^Middle button down 

5— — Middle button up 

6 — ^Ri^t button down 

7 — ^Right button up 

8 — ^Fourth button down 

9 — ^Fourth button up 

10 — ^Locator outside filter rectangle 

If Pe is 0 or omitted, all other parameters shall not be sent because the locator is 
unavailable. If Pe > 10, the entire sequence shall be ignored. 

Pb is the button code, ASCII decimal 0 - 15, indicating which, if any, of up to 4 buttons 
are down. The state of up to 4 buttons on the locator corresponds to the low 4 bits of the 
decimal value; a 1 means button is depressed. 


0 — ^No buttons down 

1— Right 

2— Middle 
4 Left 

8 — ^Fourth 

If Pb is omitted, it shall be interpreted as Pb = 0, no buttons down. 

Pr is tile row coordinate of the locator position in the page encoded as an ASCII decimal 
value. If Pr is omitted, the locator position is undefined (outside the terminal window for 
example). 
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Pc is the column coordinate of the locator position in the page, encoded as an ASCII decimal 
value. If Pc is omitted, the locator position is undefined (outside the terminal window for 
example). 

Pp is the page coordinate of the locator position encoded as an ASCII decimal value. The 
page coordinate may be omitted if the locator is on page one (the default). 

NOTES 


1. If locator reporting has been enabled to one shot mode (DECELR with Ps ■ 

2), a single locator report (DECLUP) shall reset locator reporting mode to 
disabled. 

2. The parameter values Pr, Pc, and Pp, are expressed in the units selected by 
the last received Elnable Locator Reports (DECELR) command. 

3. The parameter values Pr and Pc shall be omitted, indicating locator position 
undefined, if a position report (DECLRP) is generated when the locator cursor 
is outside the range of defined coordinates for the reporting virtual terminal. 

State Affected: 

locator_reporting_mode_t locator_reporting_mode; 
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REQUEST LOCATOR POSITION DECRQLP 


Levels: lx, 2x, 3x, 4x (Text Locator) 

Purpose: Request the terminal transmit a locator position report 
Format: 


CSI Ps ' I 

9/11 2/7 7/12 


The value of Ps controls the locator report sent as follows: 

0 — (or omitted) Default to 1. 

1 — Transmit a single locator report (DECLRP). 

Description: The host may e^licitly request a Locator Position Report (DECLRP) at 
any time locator reporting is enabled through Enable Locator Reporting (DECELR). Upon 
receipt of DECRQLP, the terminal shall respond with a single DECLRP with an event code 
of 1. 

If the session receiving the request is the active session, but the locator is not within the 
defined coordinate range for that session, the terminal shall respond with a single DECLRP 
with omitted coordinate parameter values. 

If the session receiving the request is not currently active (the locator is being used in 
another session), the terminal shall respond with omitted coordinates (locator position 
undefined) even if the input cursor is physically over the inactive session’s window. Locator 
state from the active session shall not be made available to inactive sessions. 

If locator reporting is disabled, the terminal shall respond with a single DECLRP with an 
event code of 0 (indicating locator not available to avoid timing out the appHcation). 

APPLICATION NOTE 

the terminal responds that the locator position is undefined (omitted 
coordinates), the applicati<m can ask to be notified the next time that session 
is active, and tilie locator is within the defined coordinate range. See DECEFR 
(Enable Filter Rectanid*)- 
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SELECT LOCATOR EVENTS 


DECSLE 


Levels: lx, 2x, 3x, 4x (Text Locator) 

Purpose: Tb select which locator events will generate reports 
Format: 


CSI PS...PS ' { 

9/11 2/7 7/11 

Ps ... Ps is one or more selective parameters that may assume the following values: 

0 — ^Respond only to expUcit host requests (default, also cancels any pending filter 
rectangle) 

1 — ^Report button down transitions 

2 — ^Do not report button down transitions 

3 — ^Report button up transitions 

4 — ^Do not report button up transitions 

Description: DECSLE selects which locator events shall generate unsolicited reports 
according to the parameter values. 
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ENABLE FILTER RECTANGLE 


DECEFR 


Levels: lx, 2x, 3x, 4x (Text Locator) 

Purpose: lb cause locator movement to be reported to the host. 

Format: 

CSI Pt ; PI ; Pb ; Pr ' w 
9/11 2/7 7/7 

Pt — ^Ibp boundary of filter rectangle 
PI — ^Left boundary of filter rectangle 
Pb — ^Bottom boundary of filter rectangle 
Pr — ^Right boundary of filter rectangle 

Description: The DECEFR control sequence defines the coordinates of a filter rectangle 
and activates it. The next time the locator is detected to be outside that filter rectangle, 
an outside rectangle event is generated and the rectangle is de-activated. Filter rectangles 
are always treated as one-shot events. 

Defining a new rectangle cancels the previous definition, if any, and activates the new filter 
rectangle. 

Pt, PI, Pb, and Pr are in coordinates units specified by the last DECELR sequence. The 
filter rectangle includes the boundaries, similar to other rectangular area operations. The 
origin is coordinate pair 1:1 in the upper-left comer. If any parameters are omitted, they 
are defaulted to the current locator position. Sending DECEFR with no parameters will 
cause the application to be notified for any locator movement within the defined coordinate 
space for that virtual terminal {unfiltered movement event). 

If a rectangle that does not contain the locator is specified, and the locator is within the 
defined coordinate space for that session, the terminal will generate an outside rectangle 
report immediately and de-activate it. 

NOTES 


1. DECELR cancels any previous filter rectangle definition. This guarantees 
that when an application enables locator reports, there will never be an 
outstanding filter rectangle. 

2. If a filter rectai^e lies on the edge of the defined coordinate space for 
the active session, and the locator crosses that edge, the rectangle shall 
be triggered to send a report with omitted coordinates Gocator position 
undefined). 

If flie active sessi<ni receives a filter rectangle with explicit coordinates 
while the locator is outside the defined coordinate space, the rectangle shall 
be triggered to send a report with omitted coordinates Gocator position 
undefined). 
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If tile active session receives a filter rectangle with omitted coordinates (tiiat 
is, uses the current position) while the locator is outside the defined coordinate 
space (position undefined), the rectangle shall be triggered the next time the 
locator is within the defined coordinate apace. This allows applications to 
be notified the next time the locator is within the defined coordinate space 
without polling repeatedly. 

3. If a session that is not the active session receives a filter rectangle with explicit 
coordinates, it shall trigger immediately with position undefined. If a session 
that is not the active session receives a rectangle with omitted coordinates, it 
shall trigger the next time the locator is within the defined coordinate space 
for that session, which cannot happen until the session becomes active. 

4. If the terminal receives a filter rectangle when locator reporting is not 
enabled, the rectangle shall be triggered to send a report indicating that the 
locator is not available. This is to avoid hanging the application while it waits 
for a locator report that will never occur. 

5 LOCATOR SUPPORT FOR GRAPHICS (LOCATOR PORT EXTENSION) 

The locator can also be used with the ReGIS Extension, and in Tektronix GIN mode during 
Tektronix 401x emulation. See DEC STD 070-8 Video and Printer Standards Reference 
Manual - ReGIS Graphics Extension for more information on ReGIS commands. 

5.1 ReGIS ONE-SHOT GRAPHICS INPUT MODE 

ReGIS One-Shot Graphics Input Mode is selected with R(I0). Once selected, the application 
may request graphics input using the report position interactive command, R(P(I)). 

ReGIS One-Shot Graphics Input Mode is provided for backward compatibility with the 
VT240. When an application requests graphics input, a cross hair cursor appears which 
may be positioned using either the arrow keys (as on the VT240) or a locator device. 
Pressing any non-arrow key that is not dead on the keyboard or a button on the locator 
will cause the following actions: 

1. The ASCII code or codes for the non-arrow key that was pressed is sent to the host. 
Each locator button can be programmed to send a sequence of 0 to 6 characters. This 
allows the locator to be programmed to work with existing applications (see DECLKD, 
paragraph 5.4). 

2. The coordinates of the input cursor at the time the non-arrow key was depressed are 
sent to the host, expressed as an absolute bracketed extent in user coordinates. 

3. The graphics input cursor disappears from the screen and the terminal exits graphics 
input mode. 

While the terminal is in graphics input mode, no further data from the application (screen 
output) is processed until the locator input is complete and a report is generated. 

The mouse and arrow keys may be intermixed freely in ReGIS One-Shot Graphics 
Input Mode. Since the tablet is an absolute positioning device, use of the arrow keys in 
combination with the tablet would cause inconsistent and confusing behavior. The arrow 
keys are disabled for input cursor positioning when the tablet is in proximity because the 
tablet establishes an absolute screen position. 
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5.2 ReGIS MULTIPLE INPUT MODE 

ReGIS Multiple Input Mode is selected with R(I1). In this mode, a graphics input cursor 
is displayed continuously, and individual locator events may be progranuned to send 
unsolicited position reports to the host. Characters received from the host are executed 
instead of buffered, so graphics output and graphics input may occur simultaneously. In 
Multiple Input Mode, the input cursor continues to be displayed and the mode continues 
to be in effect until explicitly exited by command R(I0). The position of the input cursor 
may be polled with R(P(I)) at any time while in this mode. If report position interactive 
is received, the report will be prefixed by the null button because no button transition 
initiated the report. 

Since host input is still being processed, it is possible to exit ReGIS (terminal receives 
String Terminator) while in Multiple Input Mode. If this happens, the ReGIS locator will 
be disabled until ReGIS is re-entered, at which time multiple input mode resumes with the 
input cursor at its last known position. 

In Multiple Input Mode, locator key transitions for which the key definition is not empty 
(see DECLKD) send a position report as follows: 

1. The locator key definition string for the corresponding button transition is sent. 

2. Tbe coordinates of the input cursor at the time of the key transition are sent to the 
host expressed as an absolute bracketed extent in user coordinates. 

3. The report ends with a carriage return. 

Examples: 

<ESC>[241~[102.5,200]<CR> 

The left mouse button was pressed. <ESC>[241~ is the default sequence for left button 
down transitions. Input cursor is at 102.5,200. 

<ESC> [240~ [ 100, 100] <CR> 

The terminal received R(P(I)) in multiple input mode. <ESC>[240~ is the null button 
sequence. 

5.3 TEKTRONIX GIN MODE 

Tektronix GIN Mode is only available during Tektronix 4010/4014 emulation. GIN mode 
is similar to ReGIS One-Shot Graphics Input mode with minor exceptions. The GIN 
request and resulting report sequences are compatible with the Tektronix 4010/4014 
series terminals. Only the cross hair graphics cursor is supported. Tektronix 4010/4014 
emulation is an exception to the architecture implemented by some graphic terminals. 
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5.4 DEFINING LOCATOR KEYS FOR GRAPHICS INPUT 

LOCATOR KEY DEFINITION DECLKD 


Levels: lx, 2x, 3x, 4x (Locator Port) 

Purpose: To assign character strings to the locator keys for ReGIS One-Shot or Multiple 
Graphics Input Mode 

Format: 

DCS Pc $ w Kyi / Stdl / Stul ; ... ; Kyn / Stnd / Stnu ST 
9/0 2/4 7/7 9/12 

Pc — Clear parameter 

0 — (or omitted) Clear all LKDs before loading new values. 

All button definition strings are empty (not the default). 

1 — Clear old definition only for keys that are redefined. 


Kyn / Stnd / Stnu — ^Key selection code n, slash delimiter (2/15), 
and string parameter n for down and up key transitions. 

Kyn is a single ASCII digit, and Std/Stu is a series of 
ASCII hex pairs. If Std or Stu is omitted, the corresponding 
button string will be empty. Key definition strings are 
delimited with 3/11 (";")• 

Description: The DECLKD device control string downline loads one or more key 
definitions for use by the Locator device during ReGIS One-Shot or Multiple Graphics 
Input Modes. These definitions are called Locator Key Definitions (LKDs). 

There are six bytes available to each of the locator keys (up to four). A power-up restart or 
Reset to Initial State (RIS) will cause the LKDs to be set to their default value. LKDs are 
not affected by Soft Terminal Reset (DECSTR). 

Default Locator Key Definitions 

No button transition ESC [ 240 ~ 

Kyi down transition ESC [ 241 ~ 

Ky2 down transition ESC [ 243 ~ 

Ky3 down transition ESC [ 245 ~ 

Ky4 down transition ESC [ 247 ~ 

Where: 

Kyi = B1 = left s barrel button 
Ky2 = B2 3 middle = tip button 
Ky3 3 B3 3 right 
Ky4 3 B4 (tablet cursor only) 
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Up Transitions are ignored by default. The following locator key up definitions are 
recommended: 

Kyi up transition ESC [ 242 ~ 

Ky2 up transition ESC [ 244 ~ 

Ky3 up transition ESC [ 246 ~ 

Ky4 up transition ESC [ 248 ~ 

NOTES 

1. DECIiED is intended for older applications that use ReGIS one-shot input 
mode with keystroke commands like A, B, C, and so forth. These commands 
can be re-bound to buttons on the mouse by sending DECLED (iHMisibly before 
running the application). 

2. A locator transition for which the key definition is empty will not terminate 
ReGIS One-Shot Graphics Input Mode. 

5.5 COMBINING GRAPHICS AND ANSI LOCATOR INPUT 

Support for graphics input in ReGIS is extended by allowing ANSI locator input (Text 
Locator Extension) to operate normally regardless of whether the host output stream is 
being interpreted as ANSI or ReGIS. If ANSI locator reporting is enabled, keystrokes and 
locator position reports can be generated without being solicited from the host. Characters 
received from the host are executed instead of buffered so graphics output and graphics 
input can occur simultaneously. 

If One-Shot Graphics Input Mode is entered (ReGIS report position interactive) while 
ANSI locator reporting is enabled, the locator cursor should change to a cross hair (not 
mandatory). Pressing a non-arrow key on the keyboard shall send the character for that 
key followed by the ReGIS user coordinates as a bracketed extent. If a locator button had 
been pressed instead, the characters for the locator button (if any) would be sent followed 
by the ReGIS position report, and finally the ANSI locator report (DECLRP) if enabled. 
Upon sending the ReGIS position report, the terminal shall exit One-Shot Graphics Input 
Mode, and the input cursor shall return to its previous state. 

The ANSI locator report is sent in the above situation (if enabled) to keep the two modes 
independent. This allows filter rectangles to continue operating, and also keeps the ANSI 
state (last DECLRP seen) consistent with the last button transition. The order of reports 
is chosen to allow a subroutine to send R(P(I)) and read the ReGIS response that follows 
without regard to whether ANSI locator reports are enabled. 

Since the ANSI locator report is in the form of a control sequence, it should not interfere 
with ReGIS reports. No special procedure is used to indicate ReGIS data from the terminal. 
This is backward compatible with the VT240 since ANSI locator reports can only occur if 
ANSI locator reporting is enabled. 

The suspension of graphics output dxuing ReGIS One-Shot Graphics Input Mode remains 
the same. This is necessary to support rubber band cursors. Rubber band cursors use the 
ReGIS output position as one reference point, and the locator input position as the other. 
Rubber band cursors are specified as an option on the ReGIS report position interactive 
command. 
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6 LOCATOR DEVICE STATUS 

DEVICE STATUS REPORT (Locator Status) DSR 


Levels: lx, 2x, 3x, 4x (Locator Port or Text Locator) 

Purpose: Cause the terminal to return the current functional status of the Locator 

Format: 

CSI ? Ps n 

9/11 3/15 Ps 6/14 

Description: The DSR request with private selective parameter 55 or 56 causes the 
terminal to respond with a similar DSR control function, using a parameter from the Ust 
below to indicate its current functional status. 

?55 Request locator status (command from host) 

?53 No locator 

?50 Locator ready 

?58 Locator busy 

?56 Host requests identity of device on locator port 

?57;0 "Unknown Locator" response 

?57;1 Device is Digital Corporate Mouse 
?57;2 Device is Digital Corporate Tablet 

The no locator response indicates no locator is currently plugged in, or the last device 
plugged in could not be initialized or has not transmitted a successful self-test message. 

The locator ready response indicates a locator device is plugged in and has transmitted a 
successful self-test message. 

The locator busy response can occur when an alternate session has selected locator 
controller mode (see following). 
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7 LOCATOR CONTROLLER MODE (GUIDELINE— DOCUMENTED EXCEPTION) 

Locator Controller Mode allows the host to communicate directly with the locator device 
without terminal intervention (similar to printer controller mode). When locator controller 
mode is set, all data received at the host port is transferred directly to the locator port 
Avithout interpretation by the display terminal. The only exceptions are the communications 
control characters XON/XOFF (if enabled), and the control sequence to disabled locator 
controller mode. All characters received at locator port are transferred to the host port 
without interpretation. The host assumes full responsibihty for the locator device. 

Locator controller mode is desirable for two reasons: 

1. It allows the host to expHcitly initialize or configure locator devices. A foreign locator 
device might not wake up in Digital format, for example. 

2. It allows the locator port to be used for other auxihary input devices. 

Locator controller mode uses the Media Copy control sequence for a secondary auxiliary 
device: 

Format: 


CSI 

6 

i 

(Turn off locator controller mode) 

9/11 

3/6 

6/9 


CSI 

7 

i 

(Turn on locator controller mode) 

9/11 

3/7 

6/9 
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APPENDIX A REFERENCED DOCUMENTS 


A.1 EL-Class Digital Documents 

EL-Ciass Number Document Title 

EL-00070-01 DEC STD 070-1 Video Systems Reference Manual - Concepts and Conformance 

Criteria 

EL-00070-08 DEC STD 070-8 Video and Printer Standards Reference Manual - ReGIS Graphics 

Extension 

Use VTX SMC to order copies of EL-class documents from Standards and Methods Control. 
Send distribution questions to JOKUR::SMC or call DTN: 234-4423. 
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14.1 INTRODUCTION 


14.1 INTRODUCTION 

The Status Display is a Level 3 feature (Level 2 extension) which 
provides the ability to display at least one additional line of 80 
characters underneath the main display. The Status Display may be 
configured as Host Writable to form a separately addressed Logical 
Display, or as an Indicator Line to display local terminal state 
information . 


14.2 FUNCTIONAL DESCRIPTION 


14.2 FUNCTIONAL DESCRIPTION 

Level 3 or higher conforming devices shall allow an additional 
line of characters to be displayed on the screen as a Status 
Display. The Status Display shall be one or more lines high and 
contain the same number of columns as the main Logical Display 
(visually 80 or 132) . 

The type of Status Display can be selected by host control 
function or from Set-Up as one of the following: (1) No Status 

Line (factory default) ; (2) Indicator Status Line (not mandatory 

for workstation or PC terminal emulators) ; (3) Host Writable 

Status Line. The type Status Display selected is saved in 
non-volatile memory (if available) , so it becomes the power-up 
default . 

The Indicator Status Line is required on traditional video 
terminals, but is not mandatory for v/orkstation or PC terminal 
emulators because local device information is often maintained 
separately from the terminal in these implementations. 

The Indicator Status Line is always selected while in Set-Up. If 
the terminal needs to display an error or warning message, the 
Indicator Status Line is temporarily replaced with the Error Line 
until the next keystroke. 

The HOvSt Writable Status Line can be considered a permanent 
separate logical display, that contains its own ANSI text state 
and settings. In general, controls which affect some portion of 
the Main Display do not affect the contents or the ANSI state of 
the Status Display. Exceptions are noted in this section (DEC STD 
70-14) . The cursor may not be positioned within the Status 
Display, unless the DECSASD (Select Active Status Display) command 
is issued. 


14.2.1 Appearance of the Status Display 
14.2.1 Appearance of the Status Display 


When the Status Display is disabled, the line where it would 
appear shall blend into the display border. Guidelines: On a 
non-over-scanned non-windowed display, the area should appear 
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black; On an over-scanned non-windowed display, the area should 
appear the same as the screen background; On a windowed display, 
the size of the terminal window may change to include the status 
line. Visual side effects caused by enabling or disabling the 
Status Display should be minimized. 

When the Indicator Status Line is enabled, it's background is the 
reverse of the Main Display background as indicated by the setting 
of Screen Mode (DECSCNM) . 

When the Host Writable Status Line is enabled, it has the same 
background as the main display. The reverse video character 
attribute may be used to cause text on the status line to appear 
in reverse video with respect to the main display. Screen Mode 
(DECSCNM) changes the background of both the status line and the 
main display. 

If Column Mode (DECCOLM) is changed, the width of the Status 
Display changes. This will leave 52 blank spaces on the right 
hand side of the Indicator Status Line in 132 Column Mode. The 
spacing between indicators will not be increased in 132 Column 
Mode, however, the host will be able to place more than 80 
characters into the Host. Writable Status Line in 132 Column Mode. 


14.2.1.1 Error Line 

14.2.1.1 Error Line 


The Error Line appears when it is necessary to indicate the result 
of some local terminal operation that would not otherwise be 
evident. An error in Set-Up for exampl.e, or a change in session 
management state. The text of the message replaces the currently 
displayed Status Line (Indicator or Host Writable) or appears if 
No Status Line is being displayed. The text of the message 
continues to be displayed until the user presses a key on the 
terminal keyboard, v/hich restores the contents of the Status 
Display. The host may not directly program or affect the Error 
Line. 


14.2.1.2 Indicator Status Line 

14.2.1.2 Indicator Status Line 


The Indicator Status Line shall contain a number of indicators 
reflecting the state of the terminal and options attached to the 
terminal (e,g. printer). The text of the indicators on the 
Indicator Status Line will be displayed in the Set-Up language. 

The indicators shall be placed in fixed positions on the Indicator 
Status Line, and there shall be at least one space (SP, 2/0) 
character between indicators for legibility. 

Indicators are updated asynchronously, as the state of the feature 
they are monitoring changes . The interval between the change in 
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the state of a feature and the update of the appropriate indicator 
shall not exceed 80 milliseconds. Indicator changes are not 
queued: when an indicator is updated on the Status Display, it 

shall reflect the state of that feature at the time of the update. 

The following indicators are required: 

1. Active Session Indicator if the Session Management 
Extension is present and the indicator is not otherwise 
available. Indicates the session to which keyboard input 
is currently directed. 

2. Active Position Indicator. Displays the current cursor 
position, row and column. Includes the page number if 
more than one page is available. 

3. Graphics Input Position Indicator if some graphic input 
mode is enabled through ReGIS, Tektronix, or the Text 
Locator extension. Indicates the pixel rovi and column of 
the input position. 

4. Edit Mode Indicator if the Local Editing Extension is 
present. Indicates whether Edit Mode (DECEDM) is 
enabled. 

5. Insert-Replace Mode Indicator if the Local Editing 
Extension is present and the terrainal is in Edit Mode. 
Indicates whether new characters typed into the Logical 
Display will be inserted, or overstrike existing 
characters . 

6. Printer Status Indicator if the Printer Port Extension is 
present. Indicates the status of the attached printer if 
any, and the print mode. 

7 . Modem Status Indicator if modem control is supported and 
enabled. Indicates the status of the DSR signal on the 
communications port. 


14.2.1.3 Implementation Guidelines for Indicators 
14.2.1.3 Implementation Guidelines for Indicators 

This subsection gives suggested formats for Indicators on the 
Indicator Status Line based on existing implementations. The 
VT340 Indicator Status Line might appear as follows (spacing is 
approximate) : 

2 1(24,008) Edit Overstrike Mode Printer: None Modem: DSR 


The Active Session Indicator is a single digit at the left most 
edge of the status line indicating the session to which keyboard 
input is currently directed. Session 2 in the example above. 

The Active Position Indicator gives the current page number within 
Page Memory followed by the cursor row and column number in 
parenthesis. Page 1, line 24, column 8 in the example above. 

The Graphics Input Position Indicator is only visible when 
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graphics input is enabled. The indicator might appear as 
"[123,456] "pixel row 123, column 456. 

The Edit Mode Indicator is only visible when DECEDM is active. 

The Indicator might appear as "Edit". 

The Insert-Replace Mode Indicator toggles between "Overstrike 
Mode" or "Insert Mode". This indicator need only be displayed 
while Edit Mode is in effect. 

The Printer Status Indicator shows the state of an attached 
printer if any (see Printer Port Extension) . The Printer Status 
Indicator can take the following values: 

Printer: None 
Printer: Ready 
Printer: Not Ready 
Printer: Auto Print 
Printer: Controller 

The Modem Status Indicator shows the status of the DSR signal when 
Modem Control is selected on the communications port. This 
indicator is not displayed if Modem Controls are not selected on 
the communications port. The Modem Status Indicator can take the 
following values: 

Modem: DSR 
Modem: No DSR 


14.2.2 Operation of Host Writable Status Line 
14.2.2 Operation of Host Writable Status Iiine 


If the Status Display is enabled to a Host Writable Status Line, 
the host is able to treat the Status Display as a separate Iiogical 

Display, generally 1 line by 80 or 132 columns. 

To write text into the Host Writable Status Line, the host must 
issue the DECSASD (Select Active Status Display) command. A 
typical operation by the host would be to send a DECSASD command 
to switch to the Host Writable Status Line, send a line of text to 
the line, and then send another DECSASD command to return to the 
Ma i n D i sp 1 ay . 

A separate ANSI state is maintained for the Host Writable Status 
Line. For example, the Status Line could have the USASCII invoked 
into GO, while the Main Display has the Line Drawing character set 
invoked into GO. When the DECSASD command is recognized, the 
terminal must switch and use the correct state information for the 
Host Writable Status Line or the Main Display. The following 
information is maintained separately for the Host Writable Status 
Line and the Main Display: 
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o Active Position 

o Current Graphic Rendition (and other character attribute 
values) 

o Origin Mode 

o the currently designated GO, Gl, G2, and G3 sets 
o the currently invoked GL and GR sets 
o the single shift {SS2, SS3) states 
o the Auto-Wrap flag 

o Cursor Save Buffer (DECSC and DECRC) 


14.2.3 Effect of ANSI controls on the Status Display 
14.2.3 Effect of ANSI controls on the Status Display 

Several ANSI control functions affect both the Main Display and 
the Status Display. When the Host Writable Status Line is 
selected, as described above, any data received by the terminal is 
placed into the Status Display, and most ANSI control functions 
received will affect only the Status Display. There are some 
control functions which are executed differently, depending on 
whether the active position is in the Main or Status Display. 

1. Cl Transmission 

The 7-bit or 8-bit transmission selection affects both 
the Main and Status Displays. 

2. Character Set Selection 

An independent state is maintained for the invoked and 

designated character sets, as well as the associated 
shift states. 

The User-Preference Supplemental Character Set selection 
affects both the Main and Status Displays. 

3. Cursor Position Controls 

If there is only one row in the Status Display, only the 
column parameters in cursor positioning control functions 
(e.g. CUP, etc.), or commands which affect areas 
dependent on character positions (e.g. ED, DCH, etc.) 
are significant. Horizontal cursor positioning commands 
(e.g. CUE, CUB) are recognized, but vertical cursor 
positioning commands (e.g. CUD, CUU) are ignored. The 
line number shall be reported as 1, when necessary. 

4. DECANM - ANSI/VT52 Mode 

This sequence is ignored if received in the Status 
Display. If received in the Main Display, the contents 
of the Host Writable Status Line are left unchanged. If 
and when the VT52 Mode Enter ANSI Mode command is issued, 
the contents of the Host Writable Status Line are left 
unchanged. 
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5. DECCOLM - Colomn mode 

DECCOLM affects both the Main Display and the Status 
Display simultaneously. The number of columns in the 
Host Writable Status Line cannot be independently 
controlled.. Receipt of this sequence will clear both the 
Main Display and the Host Writable Status Line. The 
Status Display cursor is moved to the home position. 

6. DECRQSS - Request Selection or Setting 

The Status Display Type (DECSSDT) and Active Status 
Display (DECSASD) may be queried through DECRQSS. 

7. DECSASD “ Select Active Status Display 

This control function is the recommended method to exit 
the Status Display. 

8 . DECSCL - Select Conformance Level 

Select Conformance Level performs a Soft Terminal Reset 
(see DECSTR below) . 

9. DECSCLM - Scrolling Mode 

This mode affects both the Main and Status displays. 

10. DECSCNM - Screen Mode 

The Main Display and the Status Line are affected by the 
setting of this Mode, The screen mode of the Host 
Writable Status line cannot be independently controlled. 

11. DECSCPP - Set Columns Per Page 

DECSCPP affects both the Main Display and the Status 
Display simultaneously. The number of columns in the 
Host Writable Status Line cannot be independently 
controlled. 

12. DECSSDT - Select Status Display Type 

If the Status Display Type is chosen to be something 
other than "Host Writable", the Status Display will be 
exited, and the selected Status Display Type will be 
imaged (either "Indicator" or "None") . 

13. DECSTR 

The Status Display will be exited, but not erased. 

14 . DECTCEM - Text Cursor Enable Mode 

Each of the Main and Status Display cursors may be 
individually enabled or disabled. 

15. Format Effectors (BS, LF, VT, FF, IND, NEL, etc.) 

Affect only the Status Display. If scrolling occurs as a 
result of a Format Effector, a single line Host Writable 
Status Line is erased. 
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16. IRM - Insert Replace Mode 

Insert/Replace Mode affects both the Main and Status 
displays . 

17. Keyboard Functions 

All keyboard functions are executed regardless of the 
selected display (Main or Status) . 

18. Printer Functions 

All printer functions are executed regardless of the 
selected display (Main or Status) . 

19. RIS - Reset to Initial State 

The Status Display will be erased and exited. 

20. Tabs 

Tabulation stops affect both the Main and Status 
displays . 


14.2.4 Transmission of the Status Display 

14.2.4 Transmission of the Status Display 

The characters in the Status Display can be transmitted to the 
printer by "Print Composed Main Display". Print Page and Auto 
Print Mode will never transfer characters on the Status Display. 


14.2.5 Behavior of the Status Display in VTIOO (Level 1) and VT52 

14.2.5 Behavior of the Status Display in VTIOO (Level 1) and VT52 
Mode 
Mode 

When VTIOO, or VT52 mode is entered, the Status Display will 
remain visible, if it was enabled. The sequences which program or 
change the type of the Status Display will not be recognized, 
therefore the type of Status Display may not be changed from the 
host in these modes. Sequences which globally affect the Status 
Display will still affect the Status Display, and the Status 
Display type may be changed from Set-Up. 

The Indicator Status Line will remain visible in Set-Up mode . 
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14.3 CONTROL FUNCTIONS 

14.3 TONTROL FUNCTIONS 

SELECT ACTIVE STATUS DISPTjAY DECSASD 


Levels; 2x, 3, 4 

Purpose: Select whether new characters are written to the Main 

Display or the Status Display. 


Format: CSI Ps $ } 

9/11 2/4 7/13 


Description; Causes the selection of the active status display, 
either the Main Display, or Status Display (also called the Host 
Writable or Remote Status Line) . The display is specified by the 
selective parameter, Ps; 

Ps Display 


0 Main Display (default) 

1 Host Writable Status Line 

Note that the Host Writable Status Line must be selected through 
DECSSDT for DECSASD to be able to select the Host Writable Status 
Line . 
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SELECT STATUS DISPTjAY TYPE DECSSDT 

Levels: 2x/ 3, 4 

Purpose: To select the type of status line to be displayed: 

indicator; host-writable; or none. 


Format: CSI Ps $ 

9/11 2/4 7/14 


Description: This sequence allows the host to choose the type of 

Status Line that is displayed. The type of Status Display depends 
on the value of the selective parameter: 

Ps Status Line Type 


0 No Status Line 

1 Indicator (Local) Status Line 

2 Host Writable (Remote) Status Line 

Notes: 

o If Ps is omitted, it is assumed to be 0, which will 
disable the Status Display. 

o When the Status Line Type is changed, it is initialized. 
Specifically, this means that the Host Writable (Remote) 
Status Line is cleared, and the Indicator (Local) Status 
Line is set to the Set-Up indicators, and will show the 
current status of the terminal . 

o This control has no effect on the Status Lins displayed 
in Set-Up Mode; the Indicator Status Line is always 
displayed in Set-Up Mode,, 

o The type of Status Line can also be changed through a 
Set-Up field. 

o The Status Display type may not be "locked" as a 
User-Preference Feature. 
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14.4 CHANGE HISTORY 

14.4 CHANGE HISTO^ 

14.4.1 Original draft to Rev AXOl 
14.4.1 Original draft to Rev AXOl 

1. Added Abstract and Introduction. 

2. Status Display is an extension to Level 2. DECSSDT and 
DECSASD do not work in Level 1 (VTIOO mode) . 


3 . 


Listed all sequences which affect status line including 
DECCOLM and DECSCPP . 
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DECSASD, 14-11 
DECSSDT, 14-12 

Error Line, 14-5 

Select Active Status Display 
control function, 14-11 
Select Status Display Type 


control function, 14-12 
Status Display, 14-4 
Indicators, 14-6 
Transmission, 14-10 
VTIOO and VT52 mode, 14-10 
Status Line, 14-4 

25th Status Line, 14-4 
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VIDEO SYSTEMS REFERENCE MANUAL 
VT52 Emulation 


Document Identifier: A-DS - EL00070 - OA- 0 Rev. AXll, 18-Mar-1985 


ABSTRACT: This document is an architectural statement of future 

terminal support for VT52 emulation. It includes the features of 
VT52 mode as documented in the VT102 User Guide. It does not 
include features of the VTlOO family implementation which are a 
result of cross-over with ANSI mode and are not documented. These 
features should be considered undefined conditions in terminal 
products, and cannot be relied on by software. Furthermore, the 
architecture does npt include all of the features of the actual 
VT52 products, because the intention of the architecture is to 
define the level of support necessary to maintain software 
products which already run compatibly on the entire DEC terminal 
product set. 


APPLICABILITY: SARA Formal Cross - Component Standard. Mandatory 

for Engineers designing hardware for terminal products and 
Software Engineers designing programs using terminal interfaces. 
Additional requirements are defined in the section on "Concepts 
and Conformance Criteria". 


STATUS: FOR REVIEW ONLY 


+ r - - + 

! This’ document has been placed in the SARA "Formal | 

! Cross - Component Standard" category. The material contained j 

within this document is assumed to define mandatory standards | 
unless it is clearly marked as (a) not mandatory or | 

i (b) guidelines. Material which is marked as "not mandatory" is j 
considered to be of potential benefit to the corporation and | 
should be followed unless there are good reasons for | 

I non-compliance. "Guidelines" define approaches and techniques | 
i which are considered to be good practice, but should not be | 

! considered as requirements. The procedures for modifying or | 

evolving this standard are contained within the contents of | 

this document. j 

+ + 
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A.l INTRODUCTION 
A. 1.1 Purpose 

VT52 Emulation defines a display service class for character cell 
display operations. The emulation defined here is a consistent 
and compatible subset of the functions provided by the actual VT52 
family of DEC terminals and VT52 emulation mode as documented in 
the VT102 User Guide. It does not include features of the VTlOO 
family implementation which are a result of cross-over with ANSI 
mode and are not documented. These features should be considered 
undefined conditions in terminal products, and cannot be relied on 
by software. Furthermore, the architecture does not include all 
of the features of the actual VT52 products, because the intention 
of the architecture is to define the level of support necessary to 
maintain software products which already run compatibly on the 
entire DEC terminal product set. 

A. 1.2 Scope 

This specification will be included as an appendix to the Video 
Systems Reference Manual (Video SRM). As an appendix, it is not 
considered a formal part of the architecture, and is not a 
required part of conforming product implementations. DEC products 
which implement this mode, however, should do so in accordance 
with this specification to insure compatibility with existing 
software. Software conforming to the architecture will not use 
any of the functions defined in this appendix. 

NOTE 

The algorithms defined in this appendix apply only 
to the display logic which exists when VT52 
emulation is entered correctly (i.e., all 
UNDEFINED conditions are preset to their 
prescribed values). For example, VT52 emulation 
assumes that tab stops are preset to modulus 8 
intervals. If this is not done, the logic as 
described here is not guaranteed. 
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A. 2 STATE DESCRIPTIONS 
A. 2.1 Display 

The display logic of the VT52 emulator provides the following 
features: 

o Character cell array with 80 columns X 24 lines 
o Home (1,1) at the top left corner 
o No character attributes 
o No line attributes 
o No screen attributes 
o ASCII character set 

o Line Drawing character set (* extension *) 
o Tabs at 8 column intervals. 

LINE, TYPE = 1 . .MAX _NUM. LINES ; ( * 1 tO 24 lines *) 

COLUMN. TYPE = 1 .. MAX . NUM ] COLUMNS ; (* 1 to 80 columns *) 

(* character = character code, character set *) 

CHARACTER. TYPE = RECORD 

CODE: CHARACTER. CODE. TYPE; 

CHARACTER. SET: 

GRAPHIC.CHARACTER SET TYPE; (* extension *) 

END ; 

The character set selection is an extension because the VT52 and 
other terminals do special graphics differently. 

(* display = two-dimensional array of 24 lines by 80 columns *) 

DISPLAY: ARRAY [ LINE . TYPE , COLUMN . TYPE ] OF CHARACTER . TYPE ; 
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A. 2. 2 Active Position 

The device maintains a position register known as the "Active 
Position", which serves as a reference point for graphic character 
replacement and control functions. 

CHARACTER_POSITION.TYPE = RECORD 
LINE: LINE, TYPE;’ 

COLUMN: COLUMN. TYPE; 

END; 

ACTIVE. POSITION: CHARACTER. POSITION. TYPE ; 

A. 2. 3 Tab Stops, Fixed 

The device provides a set of horizontal tabulation stops whose 
positions are fixed in hardware and cannot be changed. 

HORIZONTAL. TAB STOPS: ARRAY [ COLUMN. TYPE ] OF BOOLEAN; 

tab stops = columns 9,17,25,33,41,49,57,65,73 
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A. 3 PARAMETERS AND CONSTANTS 

This section defines the default values and ranges applicable to 
the terminal state information. 

(* Display Parameters *) 

MAX_NUM. LINES = 24; 

MAXIMUM. COLUMNS =80; 

( * 

Note; an empty character is a character position in the 
logical display in which no character code appears, and 
thus no character is rendered in the visual display for 
this position. 

*) 

EMPTY, CHARACTER = 0; 

TYPE LINE, TYPE = 1 .. MAX , NUM , LINES ; 

COLUMN, TYPE = 1 .. MAX , NUM _ COLUMNS ; 

CHARACTER, POSITION, TYPE = RECORD 
LINE: LINE, TYPE; 

COLUMN: COLUMN, TYPE; 

END ; 

CHARACTER, CODE, TYPE = 0..127; 

GRAPHIC, CHARACTER, SET, TYPE = (ASCI I, LINE DRAWING); 
CHARACTER, TYPE = RECORD 

CODE: CHARACTER, CODE, TYPE; 

CHARACTER, SET: 

GRAPHIC 'character, SET, TYPE; (* extension *) 

END ; 

A. 4 SUMMARY OF STATE VARIABLES 

The following values represent the state information necessary to 
maintain a VT52 Character Cell Display. 

VAR ACTIVE. POSITION: CHARACTER . POSITION , TYPE ; 

CURRENT, SET : GRAPHIC , CHARACTER , SET, TYPE ; 

KEYPAD. MODE: ( NUMERIC , APPLICATION ) ; 

EMULATION. MODE: ( VT52 , OFF , VT52 , ON ) ; 
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A. 5 COMMAND SUMMARY 
A. 5.1 Required Commands 


This is a list of the VT52 commands supported in the architectural 
specification: 

Identify 

Enter VT52 Emulation Mode 

Exit VT52 Emulation Mode 

Enter Alternate Keypad mode 

Exit Alternate Keypad mode 

Enter Graphics Mode 

Exit Graphics Mode 

Cursor Up 

Cursor Down 

Cursor Right 

Cursor Left 

Cursor to Home 

Direct Cursor Address 

Backspace 

Horizontal Tab 

Line Feed 

Carriage Return 

Reverse Line Feed 

Erase to End of Line 

Erase to End of Screen 

A. 5.2 Character Set Extension 

This command is in an extension to the VT52 specification because 
in the VT52 the character set is VT52 Special Graphics and in the 
VTIOO and all future terminals it is the Line Drawing set. 

Select Special Graphics Set 

A. 5. 3 VT52 Printer Port Extension 

The following commands are in an extension to the VT52 
architectural specification because they are not included in the 
standard VT52 (they are in the VT52 with printer option): 

Print Screen 

Enter Auto Print Mode 

Exit Auto Print Mode 

A. 5. 4 ANSI Printer Port Commands 

The following commands control modes that are not in the VT52 with 
printer port but are carry-overs from VTIOO printer port modes. 


Print Cursor Line 
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Enter Print Controller Mode 
Exit Print Controller Mode 
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A. 5. 5 Undefined Functions 


The following modes and commands have undefined results and states 
both when entering and exiting VT52 Mode emulation. 

Insert/Replacement Mode 
Printer Extent Mode 
Printer Form Feed Mode 
New Line Mode 
Origin Mode 
Column Mode 
Screen Mode 
Keyboard Action Mode 
Cursor Key Mode 
Line Attributes 
Character Attributes 

Character Sets (The VTIOO VT52 emulator special graphics and) 

(the VT52 special graphics are not the same. ) 

Scrolling Region 
Scrolling Mode 
Auto Wrap Mode 
Auto Repeat Mode 

Enter Hold -Screen- Mode (VT52 function not emulated) 

Exit Hold-Screen Mode (VT52 function not emulated) 

Tabs 

NOTE 

The VT52 has hardware set tabs. The VT52 emulator 
uses the tabs that were set in the terminal before 
entering the emulator. For correct use of the 
VT52 emulator, application software should set the 
tabs to the VT52 settings before entering the 
emulator . 


A. 5. 6 Programming Guidelines 

Because of the undefined interactions listed above, the terminal 
should be switched between VT52 emulation and ANSI mode only at 
program initialization. Frequent switching between modes will 
leave the terminal in an undefined state. 
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A. 6 GRAPHIC CHARACTER REPLACEMENT 
REPLACE GRAPHIC CHARACTER 


Purpose; To place a graphic character in the display at the 
Active Position, 


Format ; 


implied on receipt of graphic character data 


Description: This procedure is called on receipt of graphic 

character data to place the data in the appropriate position in 
the display structure. The character code and the current 
character set are stored in the display list. The Active Position 
is advanced by one column each time this operation is performed. 


State Affected: 

DISPLAY: ARRAY [ LINE _ TYPE , COLUMN . TYPE ] OF CHARACTER . TYPE ; 
ACTIVE . POSITION ; CHARACTER . POS I TION _ TYPE ; 


Algorithm; 

PROCEDURE REPLACE _ GRAPHIC . CHARACTER 
VAR X: COLUMN. TYPE; 

BEGIN 

DISPLAY [ ACTIVE POSITION . LINE , ACTIVE POSITION . COLUMN ] 
.CODE:= EVENT. CODE. VALUE; 

(* character set extension only *) 

DISPLAY [ACTIVE POSITION . LINE , ACTIVE POSITION . COLUMN ] 
.CHARACTER SET: = CURRENT SET; 

IF ACTIVE. POSITION. COLUMN < MAX NUM COLUMNS THEN 

ACTIVE. POSITION COLUMN:= ACTIVE POSITION COLUMN + 1; 
END ; 


Known Deviations: None 
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A. 7 CONTROL FUNCTIONS 
IDENTIFY 


Purpose; Request terminal type identification. 


Format: ESC Z 

1/11 5/10 


Description: The Identify command is a request from the 

computer for an identifying sequence. The VT52 emulator response 
is ESC / Z (1/11 2/15 5/10) (same as VT52 terminal). 

Notes: 

1. Most terminals also respond to this request when they are 
in Level 1 or Level 2 operation. Then they respond with 
an ANSI Device Attributes sequence that includes a DEC 
private registered value that indicates the actual 
termi-nal type. Conforming software should not rely on 
this response to the DECID sequence. (See IDENTIFY in 
the chapter "Terminal Management".) 


State Affected: None 


Algorithm: 

PROCEDURE IDENTIFY; 

BEGIN 

IF EMULATION, MODE = VT52_ON THEN 
WRITE (* to host *) (ESC,'/Z'); 
END; 


Known Deviations: None 
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ENTER VT52 EMULATION MODE 


Purpose : 

Format : 


Disable ANSI controls and turn on VT52 emulator. 

CSI ? 2 1 

9/11 3/15 3/2 6/12 


Description: The Enter VT52 Emulation Mode control disables 

further recognition of ANSI standard control functions in the 
terminal and turns on the VT52 emulator. This control is only 
recognized in Level 1 and Level 2 Character Cell Display 
operation. 

Notes : 

1. Execution of this control from Level 1 or Level 2 
operation does not cause the physical state of the device 
to change (i.e., the display is not cleared, and the 
Active Position does not move, etc.). 

2. In Conformance Levels 1 and 2, most VT52 control 
sequences are errors (except Identify and Exit VT52 
Emulation Mode), and in general are ignored. They should 
not be sent by conforming software. 

3. This sequence will not be treated as a control function 
when the terminal is in VT52 mode, and the effect on the 
display will be unpredictable, since it is dependent on 
the transmission environment. 


State Affected; 

EMULATION MODE = ( VT52 _ OFF , VT52 _ ON ) ; 


Algorithm: 

PROCEDURE ENTER VT52 EMULATION MODE ; 
EMULATION MODE: = VT52_ON; 

END ; 


Known Deviations: None 
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EXIT VT52 EMULATION MODE 


Purpose: Turn off VT52 emulator and allow ANSI controls to work. 


Format: ESC < 

1/11 3/12 


Description: The Exit VT52 Emulation Mode control turns off 

the VT52 emulator and turns on the ANSI parser of the terminal, 
causing the terminal to return to Level 1 operation. 

Notes : 

1. In Conformance Levels 1 and 2, most VT52 control 

sequences are errors (except Identify and Exit VT52 
Emulation Mode), and in general are ignored. They should 
not be sent by conforming software. 


State Affected: 

EMULATION, MODE = ( VT52 _ OFF , VT52 _ ON ) ; 


Algorithm: 

PROCEDURE EXIT , VT52 _ EMULATION , MODE ; 
EMULATION MODE: = VT52 OFF; 

END; 


Known Deviations: None 



VSRM - VT52 Emulation EL-00070-0A Page A-16 

*** COMPANY CONE - DEC Internal Use Only 18-Mar-1985 

ENTER ALTERNATE KEYPAD MODE 

Purpose: Auxiliary keypad keys generate application sequences. 

Format: ESC = 

1/11 3/13 

Description: The auxiliary keypad keys generate sequences used 

by application programs. 

Notes : 

1. The codes produced by the keypad in VT52 mode are shown 
in Table 1. 

State Affected: 

KEYPAD, MODE: ( NUMERIC , APPLICATION ) ; 

Algorithm: 

PROCEDURE ENTER_KEYPAD,MODE; 

KEYPAD, MODE := APPLICATION; 

END; 

Known Deviations: 

The minus, comma, and PF4 keys are not present on the VT52 
keyboard . 

In VT52 Emulation Mode, the VT125 does not transmit a code for the 
PFl key until a second key is pressed. 
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Table 1 VT52 Keypad Codes 



Alternate Keypad 

Alternate Keypad 

Key 

Mode Off (Numeric 

Mode 

On 

(Application 


Keypad Mode) 

Keypad Mode ) 

0 

0 

ESC 

7 

P 


060 

033 

077 

160 

1 

1 

ESC 

7 

q 


061 

033 

077 

161 

2 

2 

ESC 

7 

r 


062 

033 

077 

162 

3 

3 

ESC 

7 

s 


063 

033 

• 

077 

163 

4 

4 

ESC 

7 

t 


064 

033 

077 

164 

5 

5 

ESC 

7 

u 


065 

033 

077 

165 

6 

6 

ESC 

7 

V 


066 

033 

077 

166 

7 

7 

ESC 

7 

w 


067 

033 

077 

167 

8 

8 

ESC 

7 

X 


070 

033 

077 

170 

9 

9 

ESC 

7 

y 


071 

033 

077 

171 

- ( minus ) 

- ( minus ) 

ESC 

7 

m 


055 

033 

077 

155 ** 

, (comma ) 

, ( comma ) 

ESC 

7 

1 


054 

033 

077 

154 ** 

. (period ) 

. (period) 

ESC 

7 

n 


056 

033 

077 

156 

ENTER* 

CR CR LF 

ESC 

7 

M 


015 or 015 012 

033 

077 

115 


( continued ) 
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Table 1 

VT52 Keypad Codes (continued) 



Alternate Keypad 

Alternate Keypad 

Key 

Mode 

Off (Numeric 

Mode 

On (Application 


Keypad Mode) 

Keypad Mode ) 

PFl 

ESC 

P 

ESC 

P 


033 

120 

033 

120 

PF2 

ESC 

Q 

ESC 

Q 


033 

121 

033 

121 

PF3 

ESC 

R 

ESC 

R 


033 

122 

033 

122 

PF4 

ESC 

S 

ESC 

S 


033 

123 

033 

123 ** 


* When numeric keypad mode is select (alternate keypad 
mode is off), the ENTER key generates the same characters 
as the RETURN key. The RETURN key character code may be 
affected by the setting of New Line Mode. When off, this 
mode causes the key to generate a single control 
character (CR, octal 015). When on, thi-s-mode causes 
the key to generate two characters (CR,.. octal 015 and LF, 
octal 012). This interaction is UNDEFINED by the architecture, 
and should not be depended upon by conforming software. 

** These sequences are not generated by the VT52. 
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EXIT ALTERNATE KEYPAD MODE 


Purpose: Keypad generates codes for the characters shown on the 

keys . 


Format: ESC > 

1/11 3/14 


Description: Auxiliary keypad keys generate characters 

corresponding to the numeric, comma, period, and minus sign keys 
on the main keyboard. 

Notes : 


1. See Table 1 for the codes. 


State Affected: 

KEYPAD_MODE: (NUMERIC , APPLICATION ) ; 


Algorithm: 

PROCEDURE EXITKEYPADMODE; 
KEYPAD, MODE := NUMERIC; 

END; 


Known Deviations: 

The minus, comma, and PF4 keys are not present on the VT52 
keyboard . 
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ENTER GRAPHICS MODE 


Purpose: Display special graphics instead of lower case ASCII. 


Format: ESC F 

1/11 4/6 


Description: Selects the special character and line drawing 

character set. 

Notes: 

1. Table 2 lists the characters displayed and their codes, 
and compares the characters with the VT52 special 
graphics set. 


State Affected: 

CURRENT . SET : GRAPHIC . CHARACTER . SET _ TYPE ; 


Algorithm: 

PROCEDURE ENTER_GRAPHICS_MODE; 
CURRENT, SET := LINE _ DRAWING ; 
END; 


Known Deviations: 

The character set displayed is not the same as the set that was in 
the VT52. However, all terminals since the VT52 have the same 
VTlOO special graphics set. 
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Table 2 Special Character and Line Drawing Set and Graphics 
Mode Comparison 


Row/ 

US or 

Special Character and 

In Graphics 

Column 

UK Set 

Line Drawing Set 

Mode (VT52 only 

5/15 

6/0 


<> 

Blank 

Diamond 

blank 

reserved 

6/1 

a 


blotch (error indicator) 

solid rectangle 

6/2 

b 

ht 

Horizontal tab 

1/ 

6/3 

c 

ff 

Form feed 

3/ 

6/4 

d 

cr 

Carriage return 

5/ 

6/5 

e 

If 

Line feed 

7/ 

6/6 

f 

o 

Degree symbol 

degrees 

6/7 

g 

+ - 

Plus/minus 

plus or minus 

6/8 

h 

nl 

New line 

right arrow 

6/9 

i 

vt 

Vertical tab 

ellipsis (Dots) 

6/10 

j 

. 1 

Lower- right corner 

divide by 

6/11 

k 

^ i 

Upper- right corner 

down arrow 

6/12 

1 

r 

Upper-left corner 

bar at scan 0 

6/13 

m 

L 

Lower-left corner 

bar at scan 1 

6/14 

n 

+ 

Crossing lines 

bar at scan 2 

6/15 

o 

- 

Horizontal line - Scan 1 

bar at scan 3 

7/0 

P 

- 

Horizontal line - Scan 3 

bar at scan 4 

7/1 

q 

- 

Horizontal line - Scan -5— 

bar at scan 5 

7/2 

r 

- 

Horizontal line - Scan 7 

bar at scan 6 

7/3 

s 


Horizontal line - Scan 9 

bar at scan 7 

7/4 

t 

1 - 

Left "T" 

subscript 0 

7/5 

u 

- 1 

Right "T" 

subscript 1 

7/6 

V 

.. 1 . 

Bottom "T" 

subscript 2 

7/7 

w 

T 

Top "T" 

subscript 3 

7/8 

7/9 

X 

y 

< = 

Vertical bar 

Less than or equal to 

subscript 4 
subscript 5 

7/10 

z 

= > 

Greater than or equal to 

subscript 6 

7/11 

{ 

i - i 

Pi 

subscript 7 

7/12 

7/13 

} 

/= 

L- 

Not equal to 

UK pound sign 

subscript 8 
subscript 9 

7/14 


- 

Centered dot 

paragraph 
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EXIT GRAPHICS MODE 


Purpose: Display ASCII lower case characters. 


Format : 

ESC 

G 


1/11 

4/7 

Description : 

Select 

the ASCII character set 

Notes : 




1. Many terminals have included a "UK" character set, 

selectable in SET-UP. The Exit Graphics Mode command 
returns to the UK set if it was selected. 


State Affected: 

CURRENT _ SET : GRAPHIC ^ CHARACTER _ SET -TYPE ; 


Algorithm: 

PROCEDURE EXITGRAPHICS_MODE; 
CURRENT, SET: = ASCII; 

END; 


-22 


Known Deviations: 


None 
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CURSOR UP 


Purpose: Move the Active Position upward by one line. 


Format : 

ESC 

A 


1/11 

4/1 

Description : 

The 

Cursor Up control moves the Active Position 


upward by one line in the display. 

Notes: 

1. The Active Position will not move above the first line of 
the display. 

2. No scrolling will occur as a result of this control. 

3. This is the same sequence that the up arrow key 
generates . 


State Affected: 

ACTIVE _ POSITION: CHARACTER _ POSITION TYPE; 


Algorithm: 

PROCEDURE CURSOR _ UP; 

BEGIN 

IF ACTIVE POSITION. LINE > 1 THEN 

ACTIVE_POSITION.LINE:= ACTIVE _ POSITION . LINE - 1 
ELSE ( * ignore * ) ; 

END ; 


Known Deviations: None 
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CURSOR DOWN 


Purpose: Move the Active Position down by one line. 


Format: ESC B 

1/11 4/2 

Description: The Cursor Down control moves the Active Position 

down by one line in the display. 

Notes : 

1. The Active Position will not move below the bottom line 
of the display. 

2. No scrolling will occur as a result of this control. 

3. This is the same sequence that the down arrow key 
generates . 


State Affected: 

ACTIVE, POSITION : CHARACTER, POSITION, TYPE ; 


Algorithm: 

PROCEDURE CURSOR, DOWN; 

BEGIN 

IF ACTIVE, POSITION. LINE + 1 <= MAX _ NUM , LINES THEN 
ACTIVE_POSITION.LINE:= ACTIVE _ POSITION . LINE + 1 
ELSE (* ignore * ) ; 

END; 


Known Deviations: None 
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CURSOR RIGHT 


Purpose: Move the Active Position right by one character 

position. 

Format: ESC C 

1/11 4/3 


Description: The Cursor Right control moves the Active 

Position right by one character position. 

Notes: 

1. The Active Position will not move beyond the right margin 
of the screen. 

2. This is the same sequence that the right arrow key 
generates . 


State Affected: 

ACTIVE, POSITION: CHARACTER _ POSITION, TYPE; 


Algorithm: 

PROCEDURE CURSOR , FORWARD ; 

BEGIN 

IF ACTIVE POSITION. COLUMN < MAX NUM COLUMNS THEN 

ACTIVE, POSITION. COLUMN:= ACTIVE , POSITION . COLUMN + 1 
ELSE ( * ignore * ) ; 

END ; 


Known Deviations: 


None 
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CURSOR LEFT 


Purpose: Move the Active Position left by one character position. 


Format: ESC D 

1/11 4/4 

Description: The Cursor Left control moves the Active Position 

left by one character position. 

Notes : 

1. The Active Position will not move beyond the left margin 
of the display. 

2. This is the same sequence that the left arrow key 
generates . 


State Affected: 

ACTIVE . POS I TION : CHARACTER . POS I TION . TYPE ; 


Algorithm: 

PROCEDURE CURSOR BACKWARD; 

BEGIN 

IF ACTIVE, POSITION. COLUMN > 1 THEN 

ACTIVE, POSITION. COLUMN:= ACTIVE _ POS I TION . COLUMN - 1 
ELSE ( * ignore * ) ; 

END ; 


Known Deviations: None 
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CURSOR HOME 


Purpose: Move the Active Position to the home position. 


Format: ESC H 

1/11 4/8 


Description: The Cursor Home control moves the Active Position 

to the home position at line 1, column 1. 


State Affected: 

ACTIVE _ POSITION: CHARACTER _ POSITION, TYPE ; 


Algorithm: 

PROCEDURE CURSOR, HOME; 

BEGIN 

ACTIVE, POSITION. LINE:= 1; 
ACTIVE, POSITION. COLUMN:* 1; 
END ; 


Known Deviations: None 
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DIRECT CURSOR ADDRESS 


Purpose: Move the Active Position to the specified position. 


Format: ESC Y line column 

1/11 5/9 line column 


Description: The Direct Cursor Address control moves the 

active position to the specified line and column. The line and 
column numbers are sent as the ASCII characters whose codes are 
the decimal numbers of the line or column plus 31. For example, 
decimal 32 (SPACE, 2/0) refers to the first line or column, and 
decimal ^111 (o, 6/15) refers to the eightieth column. 

Notes : 

1. This command has range limits of 1 to 24 lines with 
parameters "SPACE" (2/0) to "7" (3/7), and 1 to 80 
columns with parameters "SPACE" (2/0) to "o" (6/15). An 
out of range parameter i^i— either dimension causes no 
action in that dimension, but if the other parameter is 
in range it will still be operated on. 


State Affected: 

ACTIVE _ POSITION: CHARACTER^ POSITION TYPE; 
Algorithm: 

PROCEDURE CURSOR POSITION ( LINE VALUE , COLUMN VALUE : CHAR ) ; 
VAR Y: LINE TYPE; 

X: COLUMN _ TYPE; 

BEGIN 

(* convert ascii characters to position values *) 

Y:= ORD( LINE .VALUE) - 31; 

X:= ORD( COLUMN. VALUE) - 31; 

(* conditionally update line *) 

IF ((Y >= 1) AND (Y <= MAX NUM. LINES)) THEN 
ACTIVE. POSITION. LINE:= Y; 

IF ((X >= 1) AND (X <= MAX.NUM. COLUMNS ) ) THEN 
ACTIVE. POSITION. COLUMN:= X; 

END; 


Known Deviations: None 
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BACK SPACE 


BS 


Purpose: Move the Active Position one column to the left. 


Format: BS 

0/8 

Description: The BS control moves the Active Position backward 

in the display by one column. 

Notes : 

1. The Active Position will not move beyond the beginning of 
the Active Line. 


State Affected: 

ACTIVE _ POS I T I ON : CHARACTER .-^S I TI ON , TYPE ; 


Algorithm: 

PROCEDURE BACK _ SPACE; 

BEGIN 

IF ACTIVE POSITION. COLUMN > 1 THEN 

ACTIVE, POSITION. COLUMN:= ACTIVE . POSITION . COLUMN - 1 
ELSE ( * ignore * ) ; 

END ; 


Known Deviations: None 



Page A-30 


VSRM - VT52' Emulation EL-00070-OA 

*** COMPANY CONF - DEC Internal Use Only 18-Mar-1985 


HORIZONTAL TAB HT 


Purpose: Advance the Active Position to the next Horizontal Tab 

Stop . 


Format: HT 

0/9 


Description: The HT control moves the Active Position forward 

in the display to the next Horizontal Tab Stop in the Active Line. 

Notes: 

1. If no tabulation stop is reached before the end (last 
column) of the Active Line, the Active Position will be 
set to the end of the Active Line. 


State Affected: 

ACTIVE, POSITION: CHARACTER, POSITION _ TYPE; 


Algorithm: 

PROCEDURE HORIZONTAL TAB; 

BEGIN 

REPEAT 

IF ACTIVE POSITION. COLUMN < MAX NUM COLUMNS THEN 

ACTIVE, POSITION. COLUMN := ACTIVE _ POSITION . COLUMN + 1; 
UNTIL (HORIZONTAL_TAB, STOPS [ACTIVE POSITION . COLUMN ] ) 

OR (ACTIVE. POSITION. COLUMN = MAX NUM COLUMNS); 

END ; 


Known Deviations: None 
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LINE FEED 


LF 


Purpose: Move the Active Position downward one line, scrolling if 

necessary. 


Format: LF 

0/10 


Description: The LF control moves the Active Position downward 

in the display by one line. If the Active Position is already at 
the Bottom Margin the display will scroll upward by one line. 


State Affected: 

DISPLAY: ARRAY [LINE, TYPE, COLUMN TYPE] OF CHARACTERTYPE; 
ACTIVE POSITION: CHARACTER. POSITION TYPE; 


Algorithm: 

PROCEDURE LINE. FEED; 

VAR Y: LINE. TYPE; 

X: COLUMN. TYPE; 

BEGIN 

IF ACTIVE. POSITION. LINE < MAX . NUM . LINES THEN 
ACTIVE. POSITION. LINE := ACTIVE POSITION. LINE+1 
ELSE (* scroll up *) 

BEGIN 

FOR Y:= 1 TO MAX . NUM . LINES - 1 DO 
FOR X:= 1 TO MAX . NUM .COLUMNS DO 
DISPLAY[ Y,X] := DISPLAY] Y+1 ,X ] ; 

FOR X:= 1 TO MAX NUM COLUMNS DO 

DISPLAY [ MAX . NUM . LINES , X ] . CODE : = EMPTY . CHARACTER ; 
END ; 

END; 


Known Deviations: 


None 
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CARRIAGE RETURN 


CR 


Purpose: Move the Active Position to the first column of the 

Active Line. 


Format: CR 

0/13 


Description : 
first column in 


The CR control moves the Active Position to the 
the Active Line. 


State Affected: 

ACTIVE _ POSITION: CHARACTER _ POS I TION. TYPE; 


Algorithm: 

PROCEDURE CARRIAGE. RETURN; 
BEGIN 

ACTIVE. POS I TION. COLUMN:* 1; 
END; 


Known Deviations: None 
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REVERSE LINE FEED 


Purpose: Move the Active Position upward one line in the same 

column, scrolling if necessary. 


Format: ESC I 

1/11 4/9 


Description: The Reverse Line Feed control moves the Active 

Position upward by one line in the same column in the display. If 
the Active Position is at the first line in the display, a scroll 
down is performed. 


State Affected: 

DISPLAY: ARRAY [ LINE _ TYPE , COLUMN . TYPE ] OF CHARACTER.TYPE; 
ACTIVE_POSITION: CHARACTER, POSITION _ TYPE; 


Algorithm: 

PROCEDURE REVERSE, LINE, FEED; 

VAR Y: LINE, TYPE; 

X: COLUMN, TYPE; 

BEGIN 

IF ACTIVE POSITION. LINE > 1 THEN 

ACTIVE, POSITION. LINE:= ACTIVE POSITION. LINE - 1 
ELSE (* scroll down *) 

BEGIN 

FOR Y:= MAX, NUM, LINES DOWNTO 2 DO 
FOR X:= 1 TO MAX NUM COLUMNS DO 
DISPLAY[ Y,X] := DI SPLAY[ Y- 1 , X ] ; 

FOR X := 1 TO MAX , NUM _ COLUMNS DO 

DISPLAY[ 1 ,X ] . CODE := EMPTY CHARACTER; 

END; 

END ; 


Known Deviations: None 
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ERASE TO END OF LINE 


Purpose: Erase all characters from the Active Position to the end 

of the line. 


Format: ESC K 

1/11 4/11 


Description: The Erase to End of Line control erases all 

characters from the Active Position to the end of the current line 
including the cursor position. The cursor does not move. 

Notes : 


1. The Active Position must be placed on the first position 
of the line to erase the complete line. 


State Affected: — 

DISPLAY: ARRAY [ LINE . TYPE , COLUMN _ TYPE ] OF CHARACTER. TYPE; 


Algorithm: 

PROCEDURE ERASE. TO. END OF .LINE; 

VAR X: COLUMN 'type; 

BEGIN 

FOR X:= ACTIVE. POSITION. COLUMN TO MAX NUM _ COLUMNS DO 

DISPLAY[ACTIVE.POSITION.LINE,X] .CODE:= EMPTY CHARACTER; 
END; 


Known Deviations: None 
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ERASE TO END OF SCREEN 


Purpose: Erase all characters from the Active Position to the end 

of the screen. 


Format: ESC J 

1/11 4/10 


Description: The Erase to End of Screen control erases all 

characters from the Active Position to the end of the screen 
including the cursor position. The cursor does not move. 

Notes : 

1. The Active Position must be placed on the first position 
of the screen to erase the complete screen. 


State Affected: 

DISPLAY: ARRAY [ LINE, TYPE, COLUMN. TYPE ] OF CHARACTER. TYPE; 


Algorithm: 

PROCEDURE ERASE _ TO END OF .DISPLAY ; 

VAR Y: LINE .TYPE; 

X: COLUMN TYPE; 

BEGIN 

FOR X:= ACTIVE .POSITION. COLUMN TO MAX. NUM. COLUMNS DO 

DISPLAY[ACTIVE. POSITION. LINE, X] .CODE:= EMPTY . CHARACTER ; 
FOR Y:= (ACTIVE. POSITION. LINE + 1 ) TO MAX . NUM . LINES DO 
BEGIN 

FOR X:= 1 TO MAX . NUM . COLUMNS DO 
DISPLAY[Y,X] .CODE:= EMPTY . CHARACTER ; 

END ; 

END; 


Known Deviations: None 
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A. 8 EXTENSIONS TO THE VT52 EMULATION ARCHITECTURE 

The following functions are not part of the architecture because 
many terminals, including the VT52 without printer, do not support 
them. However, all new terminals with both VT52 emulation and 
printer ports support these commands. 

A. 8.1 Print Functions 

Some terminals have serial printer ports to allow local printing. 
All print operations can be selected using sequences. Two of the 
print operations can be selected from the terminal keyboard (auto 
print and print screen). 

When printing characters from the screen of the terminal, the tab 
stops of the terminal and printer are ignored. Characters printed 
are spaced using the space (SP, octal 040) character. After the 
last printable character of a line is transmitted, a carriage 
return (CR, 015) and line feed (LF, 012) are transmitted. The 
terminal does not transmit the space characters after the last 
printable character of, a line. 

If a line contains double height characters, the characters are 
printed as two identical lines of standard width characters. 

Double width characters are printed as standard width characters 
on a single line. 

A. 8 . 1 . 1 Modes 


AUTO, PRINT MODE: (AUTO_PRINT_OFF,AUTO_PRINT ON) ; 
PRINTER. CONTROLLER_MODE: 

( PRINTER , CONTROLLER , OFF , PRINTER CONTROLLER , ON ) ; 
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ENTER AUTO PRINT MODE 


Purpose: Turn on Auto Print Mode. 

Format: ESC 

1/11 5/14 


Description: Turns on Auto Print Mode. A line on the screen 

is printed when the cursor is moved off the line. The cursor is 
moved off the line by a Line Feed, Form Feed, or Vertical Tab 
character, or when a character is received when the cursor is at 
the right margin and the auto wrap feature is selected. 

Notes : 

1. If autowrap is selected in SET-UP, it applies even in 
VT52 mode. 


State, Affected: 

AUTO, PRI NT _ MODE: (AUTO , PRINT _ OFF , AUTO . PRINT _ ON ) ; 


Algorithm: 

PROCEDURE ENTER AUTO PRINT MODE ; 
AUTO _ PRINT _ MODE : = AUTO _ PRINT _ ON ; 
END ; 


Known Deviations: None 
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EXIT AUTO PRINT MODE 


Purpose: Turn off Auto Print Mode. 


Format; ESC 

1/11 5/15 


Description; Turns off Auto Print Mode (see Enter Auto Print 

Mode). 


State Affected; 

AUTO _ PRINT. MODE; ( AUTO . PRINT- OFF , AUTO . PRINT. ON ) ; 


Algorithm: , 

PROCEDURE EXI T. AUTO. PRINT. MODE; 
AUTO . PRINT . MODE : = AUTO . PRINT . OFF ; 
END ; 


Known Deviations: None 
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ENTER PRINTER CONTROLLER MODE 


Purpose: Turn on Printer Controller Mode. 


Format : 


ESC 

w 

1/11 

5/7 


Description: Turns on Printer Controller Mode. All characters 

received by the terminal are printed by the serial printer without 
being displayed on the screen. The characters received are 
printed without being displayed or altered in any way. The 
terminal does not insert or delete spaces, provide line delimiters 
or select the proper character set within the printer. 


State Affected: 

PRINTER _ CONTROLLER _ MODE : 

( PRINTER _ CONTROLLER , OFF , PRINTER _ CONTROLLER . ON ) ; 


Algorithm: 

PROCEDURE ENTER _ PRINTER CONTROLLER . MODE ; 

PRINTER _ CONTROLLER MODE : = PRINTER _ CONTROLLER _ ON ; 
ENt) ; 


Known Deviations: None 
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EXIT PRINTER CONTROLLER MODE 


Purpose: Turn off printer controller. 

Format : ESC X 

1/11 5/8 

Description: Turns off Printer Controller Mode (see Enter 

Printer Controller Mode). 


State Affeeted: 

PRINTER _ CONTROLLER _ MODE : 

( PRINTER _ CONTROLLER _ OFF , PRINTER _ CONTROLLER. ON ) ; 


Algorithm: 

PROCEDURE EXIT . PRINTER . CONTROLLER . MODE ; 

PRINTER . CONTROLLER . MODE : = PRINTER . CONTROLLER . OFF ; 
END; 


Known Deviations: None 
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PRINT CURSOR LINE 


Purpose: Print the line containing the Active Position. 


Format: ESC V 

1/11 5/6 


Description: Causes the serial printer to print the line on 

the screen containing the cursor. The cursor position is not 
changed. The print cursor line operation ends when the line is 
printed. 

Notes : 

1. This operation can be selected from the keyboard of the 
VT52 and the VT102. 


State Affected: None 

Known Deviations: None 
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PRINT SCREEN 

Purpose: Print the contents of the screen. 

Format: ESC ] 

1/11 5/13 

Description: Causes the serial printer to print the contents 

of the screen. The print screen operation ends when the screen is 
printed. 

Notes: 

1. This operation can be selected from the keyboard of the 
VT52 and the VT102. 

State Affected: None 

Known Deviations: None 



Page A-43 


VSRM - VT52 Emulation EL- 00070 -OA 

*** COMPANY CONF - DEC Internal Use Only 18-Mar-1985 


A. 9 CHANGE HISTORY 

A. 9.1 Revision 0.3 To Rev 1.0 


1. Added the notes in the Abstract to the Purpose section in 
the 

Introduction. 

2. Added note to Scope indicating that conforming software 
will 

not use VT52 Emulation Mode. 

3. Added note to Scope indicating that all algorithms in 
this 

appendix are dependent on presetting of conditions before 
entering 

VT52 Emulation Mode. 

4. Removed the reference to ASCII as an "extension" in the 
list 

of display features, and added the Line Drawing set as an 
extension. 

5. Corrected the display size from 132 columns to 80 
columns . 

6. In note on Undefined Functions, changed "software" to 
"applications software". 

7. In Enter and Exit VT52 Emulation Mode, changed 
descriptions 

and algorithms to allow entry from any conformance level, 
and to 

exit to same level entered from. 

8. Added note to Enter VT52 Emulation Mode to indicate that 
the 

physical state of the terminal should not change. 

9. Added note to Enter VT52 Emulation Mode to indicate that 
there 

is no action when already in VT52 Mode. 

10. Added a deviation note to Enter Alternate Keypad Mode for 
the 

VT125. 

11. Cleaned up the note on the effect of New Line Mode on the 
Enter key. 

12. Corrected the description and the algorithm for Direct 
Cursor 
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Position to indicate that one legal coordinate will be 

operated 

on . 

13. Removed the note on the Active Position from the 
description 
of Line Feed. 
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A. 9. 2 Rev AXIO To AXll 


1. Changed description of EXIT VT52 MODE to indicate that it 
always 

returns, to level 1 operation. 
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ABSTRACT: This appendix contains information of general interest 

to software engineers designing software interfacing with products 
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Manual . 


APPLICABILITY: SARA Formal Cross - Component Standard. Mandatory 

for Engineers designing hardware for terminal products and 
Software Engineers designing programs using terminal interfaces. 
Additional requirements are defined in the section on "Concepts 
and Conformance Criteria". 


STATUS: FOR REVIEW ONLY 
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B.l INTRODUCTION 

This document is designed as a supporting reference to the Video 
Systems Reference Manual (Video SRM) supplied by the Terminals 
Interface Architecture (TIA) group. It covers only selected SRM 
topics, and is not intended as a comprehensive treatment of them. 

The purpose of providing a Programmer's Guide to the SRM is that 
it is probably unreasonable to expect the average programmer to 
read through the entire document and understand it thoroughly. 
Programmers are going to use the SRM for what it is - a reference 
manual. They will consult it when they need to do something, but 
they are not expected to thoroughly understand the operation of 
terminal products (as opposed to terminal implementors, who 
presumably will read the SRM in detail before their implementation 
and become thoroughly acquainted with it). The Programmer's 
Guide, therefore, is intended to provide some general context of 
what programming a terminal is all about, and to accentuate 
important points that are documented elsewhere in the SRM. 

B.1.1 SCOPE 

The Programmer's Guide applies to all DEC products which are 
intended to be certified as conforming to the Video Systems 
Reference Manual. It also applies to software which intends to 
use DEC products in a conforming manner. 
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B.2 GENERAL PROGRAMMING GUIDELINES 

The Video Systems Reference Manual contains performance 
requirements for conforming equipment, as well as for conforming 
software. A primary consideration for defining conformance 
requirements for software is to maximize its independence from the 
device. 

B.2.1 LEVELS OF ABSTRACTION 

An effective approach for terminals application programming is to 
partition the effort into distinct levels of abstraction. The 
approach is effective for one person writing one program, or 
several people writing several programs. The levels of 
abstraction are the application program, the routine library, and 
the operating system. The routine library can be subdivided into 
two parts: a logical layer and a back end layer that deals with 
the specific characteristics of the terminal being used. 

B.2. 1.1 Application Programs 

The principal guideline for application programs is to avoid the 
use of escape sequences and control sequences directly. 
Applications should make calls to subroutines to perform the 
required functions, including those at a higher level, such as 
drawing a square or deleting a paragraph, or those higher than the 
individual functions outlined in the TIA specifications. A 
library of such routines should be developed and maintained by DEC 
for its customers. 

B.2. 1.2 Routine Libraries 

Library routines can be effectively divided into two sections. 

One part of the routine can be totally independent of the data 
syntax and/or protocols being used on the device. The other part, 
the "back end" of the routines can take the 

f eatures/idiosyncracies of the specific device into account. For 
example, a library routine could implement the Insert Character 
function, but the VTlOO will not implement that in hardware. 
Therefore; the routine could perform several operations at the 
back end to perform the Insert Character function. That technique 
would allow the application program to be written as though the 
Insert Character were available on any device, thus allowing the 
customer to interface his software application to a wide variety 
of terminals and manufacturers. 
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DEC'S VMS Run-Time Library keeps the call interface to the 
application independent of the device by utilizing several back 
ends, which allows it to interface to various types of terminals, 
and permits the customer to add foreign terminal support. 

This guide is directed more to programming the back end processor 
for the routine library, than to programming the applications. 
Ideally speaking, only the library routines should receive the 
call interfaces. When it is necessary for the application to 
receive them, or where an application requires its own library, 
the guidelines outlined in this manual should be observed. 

In general, DEC systems software allows whatever functionality is 
allowed by the hardware. There may be a need at times for an 
application program to perform functions not provided by the 
library, but that are within the capability of the terminal. 

Where such functionality is added to the library, the device 
dependent features should be at the device -dependent back end as 
much as possible. 
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B.3 COMMUNICATION CONTROLS 

It is necessary to clarify the TIA interface for switching a G-set 
into the left half (GL) or the right half (GR). Such switching 
requires the use of modes, which are problematic to handle in 
software. The software works far more efficiently if the data it 
is operating on is independent of a mode context. The reason is 
that a string passed from one procedure to another encounters a 
procedure barrier, making the switch a cumbersome one. If the 
interpretation of that data is subject to a mode, the mode must be 
passed explicitly as another parameter or embedded in the string 
somehow. It is far simpler to pass the string and have its 
meaning unambiguously understood. 

For the DEC Standard 169 the left half ( GL ) of the 8-bit code is 
assumed to be the ASCII graphic set, and the right half (GR) is 
assumed to be the DEC Supplemental (Multinational) graphics. That 
assumption should be adhered to by all conforming software unless 
some very explicit, well -documented additional mechanisms are 
used. Exceptions to the norm such as code extension controls, 
locking shifts, etc. exist for the exceptional case, or for use 
by a library routine, but not by the application program. 

As covered in the previous section, library routines should 
perform all mode switching, leaving the applications as 
device-independent as possible. For instance, if a Multinational 
application wanted to use the DEC line-drawing set, it could 
simply request to draw a box from character cell position MN to 
IJ. The library routine would then perform the necessary 
switching, using the code extension, to access the line drawing 
set; when finished, it would switch back to DEC Supplemental. The 
application program would simply treat all the data that it deals 
with as ASCII on the left and DEC Supplemental on the right. 

B.3.1 TEXT ATTRIBUTES 

For text applications involving attributes such as underlining, 
bolding, etc., an effective technique is to store both the 
character code and the attributes associated with it as a single 
storage entity. This could include attributes such as character 
set, height, width, rendition, etc. An analogy to storing 
characters in this way is found in applications using integers. 
Where more complex, higher precision methods for accommodating 
numeric calculations are required, double -precision integers are 
stored with their unique attributes; they constitute a completely 
different data type than single -precision integers. 



VSRM - Programmer's Guide EL-00070-0B Page B-9 

*** COMPANY CONF - DEC Internal Use Only 15-May-1983 


B.4 CONTROL CODE EXTENSION TECHNIQUES 
B.4.1 DESIGNING CONTROL SEQUENCES 

The design of control sequences is more complex than escape 
sequences, due to the presence of private parameters and 
intermediate characters. Recommended procedure is to make the 
syntax of the control codes as consistent as possible, and as 
independent as possible from the application program. All control 
code extensions should be used by the library routines rather than 
the applications as much as possible. 

B.4. 1.1 Syntax of Parameters 

A parameter syntax option for control strings is to use leading 
zeros. Doing so can facilitate ease of programming; however, 
unless the leading zeroes are stripped off, they will be 
transmitted with the strings, slowing transmission time. A 
tradeoff decision, therefore, between ease of programming and 
transmission time is necessary. 

The same tradeoff is necessary when using omitted parameters. 
Compacting the strings makes the most efficient use of the line. 
For ease of programming, however, the program could be set up to 
transmit a string of parameters, leaving spaces for omitted 
parameters by inserting semicolons - which would transmit on the 
line and slow transmission time. The optimum method for handling 
omitted parameters is to program using the straightforward 
approach (compacting strings) and put the parameter defaults at 
the back end of the library routine. The routine could compact 
strings and omit parameter values that were equal to the default 
values, along with trailing parameters, etc. In that way, 
efficiency considerations would be at a lower level of abstraction 
than the actual logic in the library routine. Such a separation 
would provide the benefits of both line efficiency and ease of 
programming . 

B.4. 1.2 Size of Parameters 

Although the architecture does’ not limit sizes of parameter 
values, they are usually constrained by the implementation; not 
all value sizes will be recognized by all terminals. The SRM 
states that 255 decimal will be recognized by any implementation 
as a maximum value; values greater than that may not be recognized 
by some devices. The SRM also states that 16 parameters is the 
recommended maximum number for an implementation to allow in a 
string. Though some implementations may allow more than that, it 
is not safe to exceed that number; more than one string may be 
required . 
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B.4.2 TERMINAL INITIALIZATION 

It is Stated in the SRM that there is a definite technique which 
can be employed for initializing the communications line that 
should work under all states of the communications interchange. 
Examples of communications line initialization are: (1) the 
operating system broadcasting a message on a terminal while the 
application is running, (2) the application returning control to 
the operating system, and (3) the application programmer 
encountering a breakpoint during execution and entering the 
debugger . 

Generally, when the communications line is initialized, the line 
is in an unknown state when the new program takes control. The 
program may be in the middle of a control sequence, device control 
string or escape sequence. It could be in an XOFF state, with the 
terminal not accepting data, or could have switched in new 
graphics (such as the Tine -drawing set) on top of the DEC 
supplemental set. 

B.4.2.1 XON Resynchronization 

A specific sequence of instructions is required to put the 
terminal into a known state. First, communication -fterminal 
synchronization) should be restored with the XON control 
character. It will be accepted whether the terminal is in an XON 
or XOFF state. The control is ignored if the terminal is in an 
XON state. If it is in an XOFF state, the XON control will 
restore line synchronization and allow the terminal to accept 
data. 

B.4.2. 2 Control String Terminator 

The second instruction required is a String Terminator control 
character encoded as a 7-bit Escape Fe sequence. If the terminal 
is in the middle of an escape sequence, control sequence, or 
device control string, the String Terminator character terminates 
it and causes subsequent characters associated with it to be 
ignored. The sequence is printed on the terminal, and the 
terminal restored to a state in which it can accept new control or 
graphic characters. If the terminal is in none of those states, 
the string terminator character is ignored. 

B.4.2. 2.1 Printer Controller Mode 

Printer Controller Mode (MC) is a higher level management function 
than other modes. It is possible to log onto the system with the 
terminal in Printer Controller Mode, print out everything being 
executed by the applications and switch back to the operating 
system. As long as the terminal is in Printer Controller Mode, it 
will communicate to the printer, but not to the terminal. 
Therefore, if an application turns on Printer Controller Mode 
during execution, and does not turn it off, commands will not echo 
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on the terminal display when control is returned to the operating 
system. An explicit reset of Printer Controller Mode is therefore 
necessary to clear the communications line. 

B.4.2.2.2 Selecting Conformance Levels 

To put the internal state of the terminal into a known condition, 
the software must send the equivalent of a 'soft reset' which 
selects the terminal's conformance level. The Select Conformance 
Level control sequence, or DECSCL, puts the terminal into a known 
state; that state can be predicted according to values outlined in 
the SRM. 

Two conformance levels exist. Level 1 and Level 2. Application 
software should select the appropriate conformance level for the 
type of operation it intends to perform. Level 1 is defined 
strictly to provide compatibility to existing programs. Level 2 
is the preferred mode for character cell displays and for new 
software; new software using this synchronization technique should 
be able to accept and operate at Level 2. 

B.4.2.3 Full Initialization Sequence 

The following reset sequence -should be used by all operating 
systems and applications to _ initialize the terminal when taking 
control: the Control String Terminator (ST), followed by Reset 

Printer Controller Mode (ESC [ 4 i), and concluded by a Select 

Conformance Level control (ESC [ 62 " p, for Level 2 operation ). 

To insure that it works on all devices, all control codes should 

be transmitted as 7-bit ESC Fe sequences. 

The entire initialization sequence is thus: 

ESC \ ESC [ 4 i ESC ' [ 62 " p 

1/11 5/12 1/11 5/11 3/4 6/9 1/11 5/11 3/6 3/2 2/2 7/0 

B.4.2.4 Device Control Strings 

The bit combinations 08 through 13 (decimal) are provided for 
purposes of formatting the control string, but have no additional 
significance to its interpretation. The interpreter normally 
ignores the Backspace, Carriage Return, and Line Feed characters 
in a control string. Using an editor, however, it is possible to 

put those characters into a long control string in order to break 

and edit the string without effecting its interpretation. 
Backspace, Carriage Return, and Line Feed are recognized and 
interpreted in a control string within the context of the ReGiS T 
(Text) command, since it also functions as an editor. 

In summary, control characters such as Backspace, Carriage Return, 
and Line Feed are permissible in control strings syntactically, 
but are ignored functionally, except when occurring in the ReGIS 
Text Command. In some implementations, certain control characters 
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will also not be permissible syntactically, since their semantics 
is defined by the control string internal format of the particular 
device. 

It must be noted that control strings other than Device Control 
Strings (DCS), such as Application-Program Commands (APC), 
Operating System Commands (OSC) and Privacy Messages (PM) are not 
currently implemented by DEC products and should not be used by 
component software. 

B.4.2.5 Select 7-bit and 8-bit Cl Transmission Modes 

The Select 7-bit and 8-bit Cl Transmission Mode control functions 
are described in the chapter "Code Extension Layer". Since these 
modes are set by the Select Conformance Level control, it should 
not be necessary for conforming software to use them. Setting 
them via the DECSCL control allows them to be changed from the 
default values; also, it is consistent with the goal of keeping 
application software independent from terminal modes. 

The 7-bit Cl Transmission Mode causes the terminal to send Cl 
controls to the host coded as 2-character Escape Fe sequences 
instead of symbolized 8-bit controls. This mode permits existing 
software running at Level 1 conformance - in which Cl controls are 
coded only as 7 -bit - to accept 2-character Escape Fe sequences 
without changes. New software, however, should be designed to 
accept either the 7-bit or 8-bit form, in order to give the 
software independence from the terminal's mode setting. 

Note that the terminal will accept data in any format from the 
host, including 7-bit and 8-bit coding characters and 7-bit and 
8-bit Cl controls, regardless of the mode, since the modes effect 
transmission of data from the terminal to the host only. 
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B.5 TERMINAL MANAGEMENT 
B.5.1 DEVICE IDENTIFICATION 

Conforming software should use none of the device identification 
functions; terminal identification should be performed by the 
operating system. When the terminal is logged on, the operating 
system should request the terminal's functional (and/or product 
specific) characteristics, and once they are recognized, identify 
them to conforming applications. Application software can obtain 
the device characteristics from the operating system. 

B.5. 2 DEVICE CONTROL 

Controls that change the transmission modes from the host .to the 
terminal should be performed by the operating system rather than 
by applications and library routines. Library routines should 
call the operating system to change those states. In that way, 
the operating system will know and control the state with no 
necessity to monitor the output stream. Different applications 
will be able to operate the terminal in a state always known by 
the operating system. 

B. 5.2.1 Primary Device Attributes * 

The chapter "Terminal Management" describes the Primary Device 
Attributes (DAI) control. The first terminal function to be 
performed by the operating system is the Primary Device Attributes 
request, in order to determine the functional characteristics of 
the terminal. It should not be used by conforming applications 
software. This control is designed to replace the existing Device 
Attributes control used by operating systems. It allows the 
device to identify itself to the operating system by functional 
characteristics rather than by specific product characteristics. 

It does so by identifying a specific class of operations. There 
are additionally levels of operation within each class; each 
higher level is a super set of the lower levels that precede it. 

At each level, there are a number of extensions which are 
identified in response to a request. The extensions describe the, 
functional capabilities, which are essentially options at each 
level of the architecture; they may or may not be implemented in a 
given product, and/or may change from time to time. 

The benefit of the Primary Device Attributes control is that 
because devices are identified to the operating system according 
to functional, rather than product, characteristics, new devices 
can be added to the system without changing existing software. 
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B. 5.2.2 Secondary Device Attributes Control 

The Secondary Device Attributes ( DA2 ) control provides for device 
specific identification of terminals to the operating system. It 
causes the explicit product identification and revision level of 
the device to be returned. This control allows for backwards 
compatibility with previous devices and software that must know 
the product characteristics of a device that's being used. 
Conforming software should not use this control, but it is a good 
practice for operating systems to store the product specific 
information. 

B.5.2.3 Identify Terminal Control 

The Identify Terminal (DECID) control is provided for purposes of 
backwards compatibility with existing terminals. It causes the 
functional characteristics to be returned - the same response as 
the Primary Device Attributes - when the terminal is in Level 1 or 
Level 2 Character Cell mode of operation. It should not be used 
by conforming software, because it uses an encoded representation 
that is reserved for standardization by the ANSI and ISO 
standards. Should DEC implement these control standards in the 
future, any DECID sequences in use would be incompatible with the 
newly defined function. 

B.5.2.4 Select Conformance Level Control 

The Select Conformance Level (DECSCL) control allows the 
application software to set the device to a specific level of 
operation for interface compatibility. The purpose of the DECSCL 
control is to provide backward compatibility; it may be desirable 
for some implementations to operate the device at a lower level of 
conformance. The principal guideline in use of DECSCL is that the 
operating system should always operate the device at its highest 
level of conformance; it can be certain of this by selecting the 
highest conformance level (the level reported by the device) 
whenever the operating system takes control from an application. 
This technique helps to keep the software independent of terminal 
modes. 

When a level change is called for by an application subroutine, 
operating systems with the capability of doing so should keep the 
terminal in the higher-level mode and perform a translation for 
the application. For example, software not designed to accept 
8-bit characters would require the terminal to be in Level 1 mode, 
since Level 1 Character Cell Display does not transmit 8-bit 
characters. The operating system could leave the terminal at 
Level 2 Character Cell .Display and filter the 8-bit characters, 
issuing a warning (bell, etc.) if one was received. Thus, the 
state of the device would neither fluctuate nor have any 
dependence on the software. Implementing the DECSCL function via 
the operating system is more difficult and requires more 
functions, but eliminates terminal user confusion about the state 
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of the terminal. 

Another advantage of this approach becomes apparent when the user 
wishes to type information ahead to a subsequent application. For 
instance, if application A accepted only 7-bit characters and 
application B only 8-bit characters, the user could type to 
application A and, during its execution, type 8-bit characters 
ahead to application B. When application B executes, the 
operating system will begin to accept the 8-bit characters and 
pass them on. The application interprets the correct terminal 
mode at the point it actually calls the operating system for 
characters . 

B.5.3 DEVICE STATUS AND TEST 

The Test Control (DECTST) is meant strictly for hardware 
diagnostic purposes and should not be used for application or 
library software. 

B.5.4 TEXT CURSOR ENABLE MODES 

Text Cursor Enable Mode (DECTCEM) allows the cursor symbol to be 
turned on and off. This mode can be used to eliminate cursor 
fli-ekering or bouncing while the display is reformatting by 
turning the cursor off, reformatting the display, restoring the 
cursor to its position, and turning it back on. To avoid user 
confusion, the cursor should only be turned off for very short 
periods of time, and turned back on when the reformatting 
operation is finished. 
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B.6 LOCAL FUNCTIONS 

Certain keys on the keyboard have, been reserved for local 
functions. They are used in products which implement functions 
not accessible remotely. Some local functions will not be 
available in all product implementations; they will need to be 
performed by host software. The sequences for the fundtion keys 
are well defined; general applications and library software should 
not use them, and should ignore their codes if they are received. 
Ideally, the operating system should recognize the codes and 
perform the function locally, without passing them on. 

DEC assigns and maintains a designated, registered sequence for 
each function key on the keyboard. Conforming implementations 
should become familiar with this registry and use the keys only as 
designated. 

B.7 SYNCHRONIZING THE APPLICATION AND TERMINAL 
B.7.1 AUTO REPEAT 

DEC operating systems are designed such that an application, such 
as an editor, which uses the cursor keys to update a text image 
can get control frequently enough to insure that the user will not 
get too far ahead of the application, even when using Auto Repeat. 
The application program should assume responsibility for that 
synchronization, rather than attempting to do so by turning off 
Auto Repeat, locking the keyboard, etc. 

B . 7 . 2 TYPING AHEAD 

Applications should allow the terminal user to make the decision 
whether to type ahead or not; the application program should not 
make it. Problems can develop when the application program 
detects an error in the instructions that have been typed ahead. 

If a sequence is determined to be erroneous, it may not be 
executed; subsequent instructions could then produce erroneous, 
possibly disastrous, results. Therefore, it is recommended that 
applications clear type ahead only when an error has been 
detected. The application should call the operator's library 
routine, which should call the operating system to clear type 
ahead. An application program should not clear type ahead when 
starting up; it should assume that the option to type ahead 
exists, and that the operator has decided to do so. 


B..8 ReGIS GRAPHICS PROGRAMMING 
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B.8.1 SYNTAX 

B.8.1.1 Elements of Syntax 

The ReGIS syntax has five elements, the command keyletters and 
four argument types. The four types are: 

1. Numbers - which have various semantic meaning. 

2. Bracketed extents. 

3. Parenthesized extents (options). 

4. Quoted strings (used or text arguments or character 
indices ) . 


B.8.1. 2 ReGIS Flow of Execution 

The entire flow of ReGIS execution is serial. The user begins 
with a selected element which sets the state so the following 
elements are executed as they are encountered. An important 
aspect of the execution is that ReGIS doesn't require that more 
arguments be received in order to take action on a given argument . 
Generally speaking, an action can take place from within the 
context of any of the argument types. 

ReGIS actions can be visible or non-visible. An example of a 
visible action is the receipt of a position specifier while in a 
"V" (vector) state. The device would have enough information with 
that datum (and the stored state of the machine) to draw a vector 
in the appropriate line, color, pattern, etc. 

Non-visible actions are those those which change state. For 
example, if the device were working in a "W" command and received 
an option to change color, an element of state would be changed in 
the machine that would lend its attributes to all subsequent 
applicable visible actions. 

The instruction process has a well-defined hierarchical flow that 
is not too deep or extensive. The user works from the context of 
a specified command state, or at command level - outside the 
command state context. If, for instance, ReGIS is synchronized by 
some means (see next section), the system is at command level; 
subsequent arguments will be recognized but will cause no action 
to be taken, there being no command context to interpret them 
against. ReGIS arguments are self -delimiting; depending on the 
current command context, ReGIS requires proper character types to 
start and end instructions. Numbers are looked for in digit mode, 
quoted strings must always start and end with quotes, 
parenthesized extents start and end with parentheses, etc. Should 
the ReGIS interpreter be put in a non-command state at some point, 
arguments received after that will be parsed, and recognized, but 
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no action will occur. It is possible to parse through a series of 
instructions that was sent to find out what has happened, however. 

Since ReGIS allows a good deal of flexibility in including 
non - instructions with instructions, a good procedure to follow at 
points where state changes could cause problems or confusion is to 
include a statement within the instruction flow about it such as: 


;"this is a comment. State has changed here. 


B.8.1.3 Synchronization Procedures 


It is possible to put ReGIS 
syntax. For example, ReGIS 
different levels, with each 
entire instruction set. If 
parenthesis were omitted in 
out of synchronization. To 
the instruction: 


out of synchronization with erroneous 
option specifiers are nested at 
level using the same syntax as the 
a leading or trailing (left or right) 
any of the option sets, ReGIS would be 
write in the color red, for instance. 


W(I(R)) 

would be required. I (Intensity) is a parenthesized option and R 
(red) is the parenthesized extent containing the color specifier. 
If the second left-hand parenthesis had been omitted, resulting in 
the instruction: 

W( IR) 

being issued, R would not be interpreted as a subargument to the 
Intensity option, but as another option to the W command since 
it's at the same parsing level as the I. It happens that R has 
semantic meaning to the W command; it instructs to 'Write in 
Replace- mode ' . Therefore a well - structured ReGIS command was sent 
- and interpreted at the wrong level. If one of the right-hand 
parentheses had been omitted in the above command, resulting in 
the command: 


W(I(R) 

all instructions received after that command would be interpreted 
as options to the W command. Some of the instructions would be 
recognized by ReGIS in the W context, some would not, but none of 
the instructions would do what the user intended. 

Quoted string commands also can easily put the system out of 
synchronization. If the Text command 

;"this is a comment. State has changed here. 

were sent with the end quote mistakenly omitted, all subsequent 
instructions would be interpreted literally and displayed on the 
screen as text. Upon encountering another double quote, (intended 
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to be the beginning of another text string), the system would be 
back at command level interpreting characters as ReGIS 
instructions. 

It is important for the implementer to arrive at an instruction, 
or sequence of instructions, for synchronizing the system and 
Setting it to a known state, preferably at the command level. 

B. 8. 1.3.1 Parser Level Synchronization 

B. 8. 1.3. 1.1 The Semicolon 

The semicolon acts to synchronize the system from within any ReGIS 
command context - except that of quoted strings (as indicated 
earlier, command syntax is interpreted as literal text characters 
within quoted strings). The semicolon overrides the nesting level 
of options, and provides a recovery mechanism for line errors, 
programming errors and other conditions that put the system out of 
synchronization. 

The semicolon is the simplest, most straightforward method of 
synchronizing ReGIS. For instance, if a semicolon were to be sent 
before each command, it would return the interpreter to command 
level, irrespective of present command context, thus assuring the 
system is always synchronized. 

B. 8. 1.3. 2 Activation Synchronization 

Activation synchronization is not a ReGIS feature as the semicolon 
is, but is a required capability for conforming ReGIS 
implementations. The ReGIS Extension states that the mechanism 
(escape sequence, etc.) used to activate ReGIS in the product must 
contain a means of forcing the ReGIS interpreter to the command 
level. This means of synchronization is at the discretion of the 
programmer, and is implementation dependent. In some 
implementations activation synchronization has meant that the 
state of the ReGIS interpreter is preserved across changes of 
mode; in other implementations it has not. For example, the VT125 
implementation allows transition from ReGIS to text mode and back 
to ReGIS; ReGIS processing will pick up in the mode it was in 
before the transition. The GIGI implementation, on the other 
hand, does not retain the command context across a change of mode; 
the command must be reissued when returning to ReGIS. 

The optimum goal for an implementation is to allow the user to 
exit and reenter modes without restating the existing command 
context; it is recognized, however, that this goal will be beyond 
the capabilities of some products. Also, in some implementations 
it is possible that other state settings, such as color 
specifiers, etc. will not remain stable across transitions of 
mode; an example of this is when hardware is shared among various 
protocols. It is important that the implementer be awar-e of all 
such changes of state and take them into account. 
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B. 8. 1.3. 3 State Initialization 

State initialization as a synchronization method is based on the 
Screen Erase function. It is based on the following two 
requirements as stated in the ReGIS Extension: 

1. Devices which implement ReGIS extensions are required to 
implement default vhlues for all such semantic features 
which effect the visible display. 

2. For devices which have ReGIS extensions, all parameters 
and attributes - except possibly for screen attributes 
themselves - should take on their default values upon the 
execution of a Screen Erase function. 


State initialization as a synchronization method requires that 
whenever a Screen Erase function is performed, all optional 
settings (extensions to the ReGIS base logical device) must reset 
to their default values. A list of the options and their 
recommended settings is as follows: 

1. The line pattern setting should be returned to one. 

2. (Possibly) reset the loadable character set selector to 
the default character set. There are two schools of 
thought on this, however; the other one says to keep the 
last character set that was loaded. 

3. (Possibly) return the intensity selector to a default 
value upon a screen erase. 
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B.8.2 THE WRITING COMMAND' 

B.8.2.1 Writing Modes. 

A predicate of ReGIS is the pattern register, which is a binary 
pattern of I's and O's used to select between the foreground 
intensity and background intensity (also called the secondary 
foreground intensity). The W(I) command is used to write to the 
the foreground specifier, and is indicated by the I's in the 
pattern register. 

The treatment of the O's in the pattern register differentiate the 
writing modes. They are Overlay, Complement, Replace and Erase. 

A fifth mode. Negate, may be used to cancel/modify any of the 
other four. 

B.8.2. 1.1 Overlay mode - W(V) 

Overlay mode is the base ReGIS device drawing mode. It is 
generally used as the default mode, since it is the most 
straightforward and simplest to program and execute. In Overlay 
mode, all I's in the pattern register are executed into the 
display, while zeroes are not. In other words, the current 
register settin^is executed into the display. 

Overlay mode is analogous to a pen plotter that moves the pen 
along while lifting it up and down. The pen 'down' state - when 
it draws on paper - corresponds to the I's state. The pen 'up' 
state - when it moves without drawing - corresponds to the O's 
state . 

B.8.2. 1.2 Replace Mode - W(R) 

Like the Overlay mode. Replace mode executes the I's in the 
pattern register (the foreground intensity) into the display. For 
the O's, however, it executes the background intensity (secondary 
foreground color). For instance, if the background specifier is 
red, and the foreground specifier is white, the result will be 
alternating red and white dashes, irrespective of the current 
background color. 

After a Screen Erase, the behavior between Replace and Overlay 
modes is identical except at dashed line intersections, which 
disappear in Replace mode. This similarity holds true until a 
background color is set. If a red background were set. Overlay 
mode would cause a dotted white line over the background to be 
drawn, where Replace mode would cause a line with alternating 
white and red dashes to be drawn. Replace mode writing activity 
is implementation dependent. 
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B. 8. 2. 1.3 Complement Mode - W(C) 

Complement mode causes the I's in the pattern register to 
complement and O's to' not modify the display. Complement mode is 
also implementation dependent. For example, in the VKlOO (GIGI) 
Complement mode complements the display plane (which is just one 
plane deep), but does not modify the intensity attributes for that 
location. The VT125 display plane is two planes deep, and the 
intensity setting 'travels with' the drawing action, so to speak, 
and nothing is left over. After a Screen Erase, no locations have 
hidden attributes to be recovered by a Complement operation, so 
all of the bits at a given pixel location are complemented. 

Possibly the best use for Complement mode in an implementation is 
for putting the display back to its original state; this action 
occurs if the same sequence of instructions is executed twice in 
Complement mode. The results of one execution of Complement mode 
are essentially undefined or product dependent, but two executions 
reverts the display to its original state; this is true of all 
products. In this way, a cursor could be drawn, because it (the 
cursor) could be executed, and then re-executed in Complement (so 
it goes away), producing a 'blinking effect' that the user could 
predict and have temporal control over. Another possible use for 
Complement mode is to highlight a field while in Shading block 
mode. Then with a re-execution of the Complement operation, the 
display would revert to its previous state - un-highlighted and 
otherwise un-modified. 

Complement Mode should be implemented only where the programmer 
has complete control over the display medium. In more 
sophisticated systems where the programmer may not have complete, 
direct knowledge of how the screen refreshes, it should be viewed 
as a limited utility. A device's refresh method could produce 
unpredictable results with regard to Complemented locations 
(pixels). Particular caution is recommended in using it for 
systems that have layering between the users' perceived execution 
and the actual physical representation. It does not work well as 
a virtual tool, except for returning things to their original 
state as mentioned above. Even to accomplish that, intervening 
actions must'be precluded from interfering. 

B. 8. 2. 1.4 Erase Mode - W(E) 

Erase mode ignores the pattern register entirely. Its primary use 
is to clear areas and return them to the background state, 
particularly when used with shading or filling operations. A 
viewport system implementation, for example, could use it in a 
shaded area to clear a rectangle to the background state. Other 
uses of Erase Mode are: 
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1. To erase line patterns before executing other lines. 

2. To erase individual constructs on a feature - by- feature 
basis, though this use can leave background 'holes' in 
certain cases, such as at line intersection points, etc. 

3. To delete text, in some cases, though it is not designed 
for that use and is probably the least efficient way of 
doing it. 
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B. 8. 2. 1.5 Negate Mode - W(N) 

Negate Mode can work in conjunction with all the other writing 
modes. Basically speaking, it inverts the current state of the 
pattern register; the I's become O's and the O's become I's. 
Negate/Replace mode, for instance, could be used to produce text 
in reverse video, provided its setting in the character cell is 
normal. Negate used with Complement, Erase, and Overlay do not 
have any apparent utility at this point; it would be more 
efficient to invert the pattern register manually. 

B.8.2.2 Write Command Extensions 

B. 8. 2. 2.1 Raster Extensions 

The V,R,E,N and C options to the W command are implementation 
dependent raster extensions. They are the standard, compact 
writing modes which are transportable among all (and only) raster 
devices . 

B.8.2.2. 2 Open Extensions 

The F and W options to the W command are bit plane (state machine) 
controls for extremely explicit descriptions of the^riting modes. 

These options are ReGIS open extensions, since they are 
transportable to a wide range of devices, but their 
cost/performance utility is highly implementation dependent. 
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B.8.3 SCREEN INSTRUCTION 
, B.8.3.1 Hard Copy Commands 

The ReGiS Extension states that the S(H) command is used to 
retransmit the visible image on the display surface to a second 
device which may be a hard copy device. As an example, the syntax 
S(H[x,y] [x,y] ) is proper for the VT125. The H option to the S 
command is classified as a ReGIS open extension, since it isn't 
possible to predict the ability of various devices to re-dump. 

For example, a laser printer is a good device to accept ReGiS, 
even in raster format, but it isn't clear that it could retransmit 
to the raster image. 

B.8.3. 2 Address Space 

One of the key portability constructs of ReGiS is the ability to 
impose an address space. If the Screen Addressing (S(A...)) 
construct at the beginning of the session is not used, the 
application will be programmed for that particular device and will 
not transport to other devices. A good approach to this would be 
to decouple physical and logical addressing at the default level. 
For example, although the actual physical measure of DEC'S CT 
device is 960 x-240, the screen default was set at 767 x 479, 
equivalent to the VT125. In a VT125 emulation, therefore, the 
emulation and square pixel conversion has already been accounted 
for . 

It is recommended that implementations always use the S(A) 
command, even if it means re - instituting the expected device 
defaults every time. It will then be certain that defaults are 
instituted in devices being transported to and the full screen 
used rather than having the viewing area shrink into a corner on a 
large screen, or overshooting on a small screen. It provides 
reasonable certainty that some sort of reasonable screen results 
will be obtained. The use of the S(A) command is covered very 
thoroughly in the chapter "ReGiS Graphics Extension". 
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B . 8 . 4 MACROGRAPHS 

The macrograph construct is derived from the macro instruction 
construct used in assembly language programming. It is included 
in ReGIS to provide local storage of graphic commands for frequent 
reuse throughout an application. The macro concept is actually at 
a higher level than ReGIS, and could be utilized above 
combinations of protocols. ReGIS and NAPLPS, for example, are 
text stream encoded protocols which, if the proper superior 
encoding existed, could be included in a 'super parser' which 
would accept both streams of text. Each could then be invoked 
from within individual parsers to pull out its stream; this is 
possible even though the NAPLPS macro structure is not compatible 
with that of ReGIS. 

B.8.5 MACROGRAPH CONSTRUCTS 

The three constructs of primary concern to the programmer are: 
the definition of an individual macrograph, the execution of an 
individual macrograph, and the clearing of the macrograph state. 

Any combination of individual macrographs may be used and/or 
repeated in a given ReGIS command. ReGIS has a protocol - specif ic 
macro encoding built arqund a particular character, in this case 
the 'at' sign character (@). This specified character never goes 
into the ReGIS parser, regardless of context or current state of 
interpretation, because it indicates there is a macro level 
operation taking place above the parsing level. 

The free-form structure of ReGIS allows the user to enter any 
combination of characters into macrographs; they can be entire 
commands, portions of them, or some mixture of each. When the 
macrograph invocation character is recognized at the pre-parser 
level, the macrograph data base is interrogated and the substitute 
character string read out. That character string is applied in 
the existing context of the ReGIS interpreter. For example, if 
ReGIS were at command level and encountered a macrograph the 
contents of which began with a "V", the ReGIS context would be 
changed to the Vector interpretation state and the remainder of 
the macrograph read within that context. Each character contained 
in the macrograph would be interpreted by the parser as though it 
had appeared individually along the communications line. 
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B.8.6 MACROGRAPH INVOCATION 
B.8.6.1 Macrographs Invoking Others 

Macrographs may invoke other macrographs; ReGIS recognition of 
macrographs is recursive. It should not be assumed that the 
entire contents of one macrograph will fall directly into the 
ReGIS state. One or more of the commands may be invoking other 
macrographs. 

B.8.6. 2 Macrograph Invoking Itself 

A macrograph cannot invoke itself. Invocation of macrographs is 
entirely deterministic and non-conditional, since there are no 
conditionals in ReGIS. Therefore, it would not be possible to 
recognize an 'exit' condition in a macrograph that invoked itself. 

For example, a path from macrograph D through other macrographs 
that further invoked macrograph D would repeat that same path 
predictably and exactly, resulting in an unbounded recursion 
requiring error recovery. In ReGIS devices, unbounded recursions 
are usually implemented so that the recursion stack overflows, 
creating an error condition which purges everything back to 
command level. It is entirely illegal to use any sort of 
recursive macrograph invocation, direct or indirect. 
Implementations may insert a flag that signals as each macrograph 
is accessed. For instance, it would signal when macrograph D were 
being accessed. If macrograph D invoked macrograph L, macrograph 
L would be flagged as accessed, if L invoked X, X would be so 
flagged. If X then invoked D, L or X, the flag would recognize an 
unbounded recursion state and terminate. Recovery mechanism and 
recovery recognition scheme is the responsibility of the 
implementation; the ReGIS Extension does not impose one. 

B.8.7 MACROGRAPH STORAGE 

ReGIS provides for exactly 26 separate macrographs, irrespective 
of implementation. While the ReGIS Extension calls for a minimum 
of 4000 characters macrograph storage, this may be an 
implementation dependent value due to device limitations. Should 
a user need to know the amount of available macrograph storage 
space, a ReGIS inquiry function exists which allows the user to 
interrogate the system. Otherwise, a 4000 character storage space 
should be assumed. 
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There are 'hooks' at certain points within ReGIS into the 
macrograph storage. The Report command, for example, can send 
back details of space, usage, or individual macrograph contents. 

So macrographs do enter the parser, even though they are superior 
to it conceptually. 

While a macrograph can define the invocation of another 
macrograph, it cannot define its storage because macrograph 
definitions cannot be nested. The macrograph initiator and 
terminator are specific constructs. The macrograph initiator is: 

'at' sign (@) 
colon , 

letter (macrograph name) 

The macrograph terminator is: 

'at' sign (@) 
semicolon . 

The macrograph initiator immediately turns off all ReGIS and 
nearly all macrograph parsing. At that point, the only construct 
which will not be stored in a macrograph is the terminator. It 
is, therefore, impossible to nest macrograph definitions. The 
following sample instructions illustrate an attempt to nest 
definitions in macrographs A and B: 

@:A @:B(contents of B) (remaining contents of A)@; 

These commands would not be interpreted as expected because the 
second instruction (@:B) would not be recognized at the macrograph 
storage level; it would be stored literally in the macrograph. 
Also, the first ( @ ; ) (third instruction) would be recognized as 
the termination of the entire macrograph extent. The last 
instruction, intended to invoke the remaining contents of 
macrograph A would be passed along to the parser, since all the 
macrograph storage constraints would have been satisfied; the 
final (@;) would simply act as a spurious terminator. 

B.8.8 MACROGRAPH UTILITY 

B.8.8.1 Specifications 

Macrographs have been used effectively for storing combinations of 
specifications. Although ReGIS technically does not have the 
capability for named variable storage, macrographs can provide the 
capability to a limited degree. The following example macrograph 
(R) stores the HLS specification for the color red (hue 120, 
lightness 50 and saturation 100). 

@:R H120 L50 SlOO @; 

This specification could be invoked within the context of a Write 
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mode instruction, as a suboption to the I command as follows: 

W(I(@R)) 

or as a screen mapping command: 

S(M 3 (@R)-) 

Though the context varies, the same macrograph is used. The 
macrograph character stream is a literal stream; it could be 
invoked as two characters at the device, rather than the 
specification being retransmitted as several characters from the 
source. 
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B.8.8.2 Polygons 

Macrographs can be used to define polygons. To accomplish this, 
the macrograph can be stored and executed twice, and the Write 
modes changed outside the macrograph. For example, Shading mode 
could be turned on, and the macrograph invoked; this would draw a 
shaded area in the shape of a polygon. Shading could then be 
turned off, the macrograph invoked again, the color changed and ' 
the border drawn around the polygon. Thus, the description of the 
polygon would be stored in the macrograph, and could be drawn 
shaded with a highlighted border. 

B . 8 . 8 . 3 Icons 

Macrographs can be used effectively for drawing icons. The user 
may want to draw an icon that can be stored away for repetitive 
use, such as a Stop sign, for example, to be displayed at 
different places on the screen at different times. A line drawing 
of the picture could then be plotted out using only relative 
coordinate specifiers within vector imposition commands as the 
following example which draws a star: 

@:I V[+20, -50] [+20,+50] [ -50, -30] [+60, ] [ -50,+30] @ ; 

From command level, the cursor could then be positioned at a 
desired point and- the macrograph invoked to display the icon: 

P[x,y] @I 

Once the icon were positioned, other drawing operations could be 
performed on the picture, changing writing modes as necessary. If 
writing in Complement mode, the icon could be cleared out, if 
desired, by invoking the macrograph again in Complement mode at 
the same point. 

This technique provides a cursor support capability. For example, 
if an interactive application required the tracking of an input 
device and the particular ReGIS device did not support Locator 
mode report, a cursor icon could be programmed to write, move, 
erase itself as necessary, or perhaps just display itself 
repeatedly - such as for graphing structures. 
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.B.8.8.4 Coordinate Lists 

Macrographs provide the capability of storing a coordinate list. 

Two examples show how data compression can be used in macrographs 
to do a variable presentation of a picture by storing away entire 
command lists. The following example shows a set of bracketed 
extents within a macrograph used in a Vector construct to draw a 
Begin and End block around the outside, creating a closed polygon: 

@:C [ ][ ][ ]@; vec V(B)@C(E) V(B)0C(E) 

The same structure could then be invoked as a closed curve 
construct. Macrographs can be used in this way to demonstrate how 
the closed curve command works in ReGIS; a specified sequence of 
points are first connected with vectors and then with curves. 

Another use for this type of curve construct is to invoke a 
different macrograph inside the command in order to apply markers 
at each point along the coordinate list extent. The following 
example has a coordinate list contained in macrograph C: 

0:C 0M[ ] @M[ ] 0M[ ] @M[ ] @M[ ] @; 

Between each specified coordinate, another macrograph (M) has been- 
invoked which could be an icon such as a small square. If these 
instructions were executed as a polygon or an open vector set 
extent, they could send nested calls to a different macrograph to 
generate a graph, for instance, and draw the icon (small square) 
marker at each coordinate space to mark the position on the curve 
extent : 


0:.M P[+10, -10 ]V[+20 ] [ ,+20] ( -20] [ , -20 ]P[ -10,+10] 0 ; 

If it were necessary to streamline the execution and not display 
the icon, the definition of macrograph M could be nulled; it would 
be invoked as an empty extent between every coordinate point and 
execute directly, causing no extra overhead in the display. 
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B.8.8.5 Write Maps 

The macrograph structure has been used as a surrogate Write map by 
DEC'S Datatrieve system. Datatrieve allows the user to change the 
Write map settings in order to present a graph in different 
colors, changing the shades as desired. However, Datatrieve 
requires the default Write map to suppress the display while 
entering an expanded text menu. Datatrieve protects the default 
Write map settings from destruction by the user's Write map 
settings by loading the user Write map settings into a macrograph. 

Datatrieve is then able to clear the user Write map away while 
performing its expanded text menu operations, invoking the 
macrograph to restore the user Write map settings again. The 
following shows a macrograph (Z) structure containing the user 
Write map settings. 

@ : Z S ( Mn ( ) n ( ) ) @ ; 

The code that interrogates the user for color settings, etc. 
actually modifies the macrograph and invokes it. Datatrieve can 
then perform other operations, changing the Write map if 
necessary, restoring the user settings with the macrograph 
afterwards. — 

State features such as the Write map are not accessible to the 
Report command of ReGIS; in a system application such as 
Datatrieve, the system and the application both have access to 
that feature of the machine. Macrographs are used in this case to 
prevent the competing entities from writing to the same extent 
(without making private copies of that extent), so it can be 
restored later in an unambiguous fashion. 

B . 8 . 8 . 6 Text 

Macrographs have limited application for standard cell text; most 
individual sections of text do not warrant the overhead of storing 
and recovering things by name. However, for situations where 
short and medium length words such as "the" and "first" are used 
frequently, macrographs can be used to refer to them by 
abbreviations. This would be keeping with coding efficiency 
principles that advocate using the least number of characters as 
possible. 

Storing text in macrographs also presents the possibility of 
creating menus; it is a combination between display lists and 
local buffering of intelligence at the ReGIS device. Macrographs 
provide another tool for that type of system. 
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B. 8. 8. 6.1 Quoted Strings 

A caution in using macrographs for text is that they are not 
recognized or interpreted within quoted text strings. Therefore, 
it is not possible to use a Text command to invoke a macrograph 
contained within quoted strings, because the contents of quoted 
strings will be interpreted literally. 

Conversely, it is possible to put all or part of a quoted string 
within a macrograph. However, the use of unmatched quotes in 
macrographs will produce erroneous results. The following sample 
instructions invoke macrograph X containing a Text command, quote 
character and the first part of a quoted string, followed by 
macrograph Y containing the remainder of the string and a closing 
quote character. 

@:X T'(text) 0:Y (remainder of^text)' 0; 0X0Y 

The first instruction invokes macrograph X which sends the Text 
command to the parser. The next command is supposed to invoke 
macrograph Y, but the ReGIS parser has been instructed to execute 
quoted text (by the open quote in macrograph X) and has received 
no instruction to do otherwise. The result will be: 


T, '(text) 0Y 

with no closing quote. This would will display as: 

(text)0Y 

and leave ReGIS out of synchronization. This result is obviously 
much different than what the user wanted or expected. 

B.8.8.7 Display Segments 

The ReGIS Extension states that macrographs are not intended for 
use as display segments. In most instances, the complexity 
required to support segmented displays is beyond the scope that 
can be offered by macrographs. As indicated earlier, just 26 
macrographs are allowed, and a relatively small amount of storage 
(4000 character minimum) usually allotted. Most implementations 
will have storage in that range; a powerful implementation would 
likely have no more than twice that amount. A complex display 
file structure would be difficult, though not impossible, within 
those limitations. Pieces of pictures, each treated as a segment, 
could be stored away in macrographs and executed in turn. Proper 
Write modes could then be chosen outside the macrograph level, 
turned on and off non-destructively , opaqued with others, etc. 
Therefore, this application of macrographs does exist, but on a 
limited basis. 
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B . 8 . 9 THE TEXT COMMAND 

B.8.9.1 Sizing Text - the S Option 

The best method for sizing text is the T(S) command with an 
integer argument. ReGIS will scale the character by the integer 
factor in horizontal and vertical extent, and set a default 
spacing into character escapement for character strings, until the 
S option changes again. For single-size characters, the 
instruction is T(S1). For double-size characters, the instruction 
is T(S2) . 

Another text sizing method is to use the S and H options with 
integer arguments. The H effects the height of the character 
only; it allows further changes to be made to the aspect ratio of 
the character extent and whatever changes required in text spacing 
to make that fit. To obtain standard -width characters at twice 
the height, for instance, the instruction would be T(S1, H2 ) . The 
H option will work only after the S option, since only the height 
can be altered after the size has been set. The instruction T(H2, 
S3), for example, will produce characters three times as wide and 
three times as high because S sets both height and width, 
overriding any previous settings. 

A default character cell size called a 'unit size' has been 
implemented in the newer versions. Basically, it amounts to the 
fact that the character definition as loaded into the program ROM, 
or down loaded in the Load Character extent, is treated as a 
logical display (that is, a selectable number of current 
coordinate units is used for each parameter of the character's 
height and width). The window for that character has the entire 
extent of the logical display for that character and can be 
viewported into a unit size on the screen. 

The T(S) command fulfills most text sizing requirements, but 
doesn't provide for a way to know the actual size of the 
characters, or how many of them will fit across the display. For 
instance, if the unit size is unknown and a "standard size one" 
character is asked for, the actual size of the characters, plus 
how many will fit across a screen will be unknown. The T(S) 
command will give some relative size scaling, but the results will 
be trial and error without knowing the unit size. 
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B.8.9.2 The S Option Coupled With Other Options 

B. 8. 9. 2.1 Specifying Screen Area - -The S, M and U Options 

When coupled with the M option, the S option can be used to 
specify the amount of screen area the character will take up. 

When coupled with the U option, the use of the S option is more 
complicated, but also provides another means of predicting the 
amount of screen area the character will take up. The U option 
should be understood in order to figure out how to get 
transportability across various text resolution displays. When 
used with the S option, it becomes possible to size text without 
knowing the unit sizes, but the actual results will be 
implementation dependent. Most implementors program their devices 
at maximum resolution, making detailed text representation a 
necessity; the handling of detailed text in ReGIS is complex and 
highly device dependent. 

B.8.9.2. 2 Character Orientation - The S and D Option 

The relationship between the size (S) and direction (D) options is 
a complicated one. The D option controls the orientation of the 
character cell. When used in conjunction with the S command in 
the same option set, it has the side effect of changing not only 
the cell orientation, but the intercharacter movement. If the S 
option is used with the D option, it couples the direction 
specifier to the character baseline. For instance, if the string, 

T(D90 S1)"ABCD" 

is sent, the characters will be oriented to each other as follows: 


This technique can provide a way of labelling the Y axis of 
graphs, or can be used in other applications as well. 

A D90 instruction without the (S) specifier simply rotates the 
characters 90 degrees clockwise (an angular orientation, not a 
pixel orientation) so the characters will display as follows: 


The S and D options work for whatever character angles the 
implementation can support. The simplest and most portable 
character orientation is in 90 degree increments, though 45 degree 
increments will usually also work. ReGIS allows arbitrary 
character orientation, but product limitations usually prohibit it 
and round to the nearest 45 or 90 degree increment. 
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B.8.9.2.3 Text Bracketed Options - Space Setting 

The T(S)[] command may be used to provide certain specific 
controls. Using a bracketed argument with the T command, for 
example, forces an intercharacter space setting that overrides any 
space defaults set by the character size. This can be used to 
change the perceived orientation of the lines of the character, 
the character path. An example of a character path altered in 
this manner can be found in Figure 8-6 of the ReGIS Extension. 
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B.8.9.3 Text Control Characters 

ReGIS has three basic text control features: backspace, carriage 
return and line feed. Implementing them is straightforward in the 
base logical device, since text re -orientation (see above) is not 
possible in the base logical device. Carriage return returns to 
the start position of the text string being worked in. A line 
feed moves down one line vertically, without changing its 
horizontal position. Consecutive line feeds move along 
vertically, but the X position never changes because with no 
reorientation, the text runs horizontally from left to right. 

Since there is no vertical component to a Carriage Return, text 
following a Carriage Return goes to the left hand position; this 
is true with every text command and argument. Backspace moves 
back one position and overstrikes the character. It is possible 
with the backspace to go beyond the carriage return position. 

In most implementations. Backspace, Carriage Return and Line Feed 
will work with rotated text. Carriage Return moves along the 
baseline orientation to either the position at the beginning of 
the T command, the beginning of the last quoted extent, or to the 
point at which the last Line Feed was encountered. Using CR and 
LF control characters, it should be possible to do a rotated block 
of text as follows: 


To summarize, it may be stated that the control characters operate 
in a way that preserves the logical functions of Backspace, 
Carriage Return and Line Feed, irrespective of character 
orientation. These three controls also provide a shorthand method 
of putting the drawing point at a predictable location; 
alternative methods of accomplishing this are either to use the 
pixel vector specifiers or to leave the text command and send a 
relative position argument each time the drawing position changes. 

Other text control characters, such as horizontal and vertical 
tab, are not covered in the ReGIS Extension, because they lose 
their meaning when the baseline is neither horizontal or vertical, 
or when character sizes and aspect ratios change. 
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B. 8. 9. 3.1 Pixel Vector Specifiers 

The text control characters described above provide a means of 
moving the drawing position in relation to the text characters. 
Another means of moving it is to use pixel vector specifiers as an 
argument within a text command. These may be included between 
quoted string arguments (though not within the quoted string). 

The way to write a superscript 12 to the ABCD text, for instance, 
is with the following command: 

T"ABCD’’2"12"6 

which is the text, the pixel vector specifier to move the position 
up, the superscript characters, and the pixel vector specifier to 
move the position back to baseline. The pixel vector specifiers 2 
and 6 move the drawing position up and down, respectively. Pixel 
vector specifiers used in this manner move the drawing location 
for the next character cell one-half character size. Pixel vector 
2 would move the drawing position up one half the character 
height, while 22 would move it up a full character height. Text 
pixel vectors are measured differently from standard pixel 
vectors. Text pixel vector 0 is always in the direction of the 
text string, 2 is always up from the character baseline and 6 
returns to the baseline. Standard pixel vector 0 is to the right, 
2 is vertically up, 4 is to the left, and 6 is vertically down. 
Therefore, text can be superscripted/subscripted with the same 
pixel vectors whether or not the string is rotated. Pixel vector 
specifiers are covered in various places in the ReGIS Extension, 
since they are included in the base logical device as well as the 
raster and open extensions. 

B.8.9.4 Scrolling and Wrap 

ReGIS has no provision for scrolling or wrapping text, making it a 
very limited tool for general text purposes. Since there is no 
screen margin for text, the system keeps incrementing its X and Y 
pointers and goes beyond the margins and bottom of the screen. 

The user may be able to effect a "manual wrap" if the extents of 
the screen, the size of the character, the number of characters 
across, etc., are known. However, the system would still be 
without a general-purpose scrolling function that could satisfy 
text requirements. 

The type of scrolling offered by ReGIS is graphics-oriented and 
highly device dependent. In the open extensions section of the 
ReGIS Extension, two scrolling methods, or models, of moving data 
in a graphics display are described. One model "shifts the data 
through the space" while the other "moves the viewpoint around 
within the data address space". 
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B.8.10 COLOR MAPPING 

Color mapping is parameterized in ReGIS through the HLS reference 
model. The RGB model essentially duplicates the HLS model and is 
not fully parameterized in ReGIS. For instance, it is not 
possible to color a figure 20% red, 40% green, and 8% blue. The 
only ReGIS possibility with the RGB alphabet is to specify the 
distinct colors red, blue, yellow, cyan, magenta, black or white, 
which are all fully saturated colors at their maximum intensity. 
HLS provides the easier model with which to understand colors from 
a human point of view, since it is based on a perceptual model. 

It identifies a set of dimensions for color specifications that. is 
based on what people perceive the three elements of color to be. 
The hue specifier, for instance, indicates the tint, which is the 
major determinant of the color. The hue specifier is based upon 
an angular specification that runs from 0 to 360, with blue at 0, 
red at 120 and green at 240. To change color to a hue between 
blue and red, the angular parameter between blue and red is 
adjusted . 

The L parameter adjusts color lightness to specify how bright or 
dim the color is. The S parameter indicates how pastel the shade 
is - how much that color varies between a gray and a pure 
present;ation at the specified hue and lightness. Color mapping 
requires a 3 -dimensional specification; all three are needed to 
produce the precise representation of the color. The HLS model 
has well-defined end points and, while it is not linear along any 
of the axes, it can be interpreted as linear for the rough scale 
of models that we have. 

B. 8. 10.1 Color and Gray Scale. 

In theory, programs written for color will produce a corresponding 
visual effect on a non-color device that supports only gray scale. 
In practice, however, it will not transport perfectly because the 
ReGIS color model and gray scale is "grainy". Having just four, 
eight or sixteen individual colors visible at any given time or on 
a given gray scale limits the ability to shade a particular color 
to a particular shade of gray. A two-dimensional extent is being 
imposed into a one - dimensional extent, and some information loss 
is inevitable. If two colors that map very closely on the gray 
scale are used ( such as bright blue and dim green in television) 
they could 'collide', or map to the same shade on the ReGIS gray 
scale. It is actually largely determined by the product's 
hardware. In most cases, if standard colors are used, or a widely 
varied set of colors,, the chances of gray scales colliding with 
map from the colors is probably not too great. It is recommended 
to not use non-standard color gradations to present information. 
Standard, bright colors such as red, green etc. with the same 
whiteness saturation and only varying hues will produce 
discernible gray scales. 
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B.8.11 INTEGRATION OF GRAPHICS AND TEXT 

ReGIS provides very limited control over registration between text 
and graphics, particularly across devices, or when the text is 
created with other than the ReGIS Text command. For example, an 
attempt to use VTIOO text as captions for VT125 figures would be 
severely hampered by insufficient control over scrolling in the 
VTIOO. Also, column modes (widths) between the two devices would 
be difficult to synchronize, since it would not be known whether 
the user wanted the VTIOO column mode set to 132 or 80 columns, or 
whether the device had an advance video option with only 14 lines 
in 132-column mode. 

Another integrating situation that would encounter problems would 
be to attempt to integrate text that was created in the Text mode 
of the VT240 instead of with the ReGIS Text command. 

The real utility of integrating editable text with graphics is 
that while composing, the user views the work outside of the 
context of the terminal being used; the graphics and text are 
viewed in a unified text environment. This requires the ability 
to address the application of various protocols to obtain 
predictable, integrated results, and is not currently feasible 
with the various text and graphics protocols used by DEC. To 
avoid incompatibilities with future products, application software 
should not depend on interactions between graphics and- text. Some 
examples of interactions to avoid follow: 

1. Using the graphics erasing command S{E) to erase text. 

2. Using (non-ReGIS) text erasing commands to erase all or 
part of the graphics image. 

3. Using graphics scrolling to scroll text. 

4. Using text scrolling to scroll graphics. 

5. Mixing text and graphics in the same screen area. 
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Applications which need to label graphs, charts, etc., or which 
need to perform advanced text functions such as proportional 
spacing, italics, colors, etc. should use the ReGIS T command 
exclusively, and not mix graphics text with text mode text. 

A 

B 

C 

D 

ABCD 

ABCDEFGHIJ 

KLMNOPQRST 

UVWXYZABDE 



VSRM - Programmer' 
*** COMPANY CONF - 


s Guide EL-00070-OB 
DEC Internal Use Only 15-May-1983 


Page B-42 


This page deliberately left blank 



VSRM - Programmer's Guide EL-00070-0B Page B-43' 

*** COMPANY CONF - DEC Internal Use Only 15-May-1983 


Section Index 


-A- 

B-6 
B-16 


Application Programs 
Auto Repeat 


-C- 


Color Map B-39 
Conformance Levels . B-11 
Control Sequence 

use by application programs B-6 
use by applications programs B-9 


-D- 


DAI 

B-13 

DA2 

B-14 

DEC STD 169 

B-8 

PEC Supplemental Graphics 

B-8 

DECARM 

B-16 

DECID 

B-14 

DECSCL 

B-11, B-14 

DECTCEM 

B-15 

DECTST 

B-15 

Device Attributes (Primary) 

B-13 

Device Attributes (Secondary) 

B-14 

Device Control String , • 

B-11 

Device Identification 

B-13 

Device Test 

B-15 

-E- 

Escape Sequence 

use by application programs 

B-6 

-G- 

GL 

B-8 

GR 

B-8 

- 1 - 


Identify Terminal 

B-14 

Integration of Text and Graphics 

B-40 



VSRM - Programmer's Guide EL-00070-0B Page B-44 

*** COMPANY CONF - DEC Internal Use Only 15-May-1983 


-L- 


Level 1 B-11 

Level 2 B-11 

Levels of Abstraction B-6 

Local Function Keys B-16 

-M- 

Macrograph B-26 

Mode Switching B-8 

-P- 

Primary Device Attributes B-13 

Printer Controller Mode B-10 

Programmer's Guide B-5 


-R- 


ReGIS 

address space 

character orientation 

color map 

extensions 

hard copy 

initialization 

macrograph 

pixel vector specifiers 

screen area 

scrolling 

text command 

wrap 

writing modes 
Regis 

synchronization 
ReGIS Syntax 


B-25 

B-35 

B-39 

B-24 

B-25 

B-20 

B-26 

B-38 

B-35 

B-38 

B-34 

B-38 

B-21 

B-18 

B-17 


-S- 


S7C1T 

S8C1T 

Secondary Device Attributes 
Select 7-Bit Cl Transmission 
Select 8-Bit Cl Trasnmission 
Select Conformance Level 
Software Conformance 
String Terminator 
Subroutine Library 


B-12 

B-12 

B-14 

B-12 

B-12 

B-11, B-14 

B-6 

B-10 

B-6 



VSRM - Programmer's Guide EL-00070-0B Page B-45 

*** COMPANY CONF - DEC Internal Use Only 15-May-1983 


-T- 


Terminal Initialization B-10 

Terminal Interface Architecture B-5 

Text Attributes B-8 

Text Cursor Enable Mode B-15 

TIA B-5 

Type Ahead B-16 

-X- 

XON/XOFF B-10 



VSRM - Product Reference EL-00070-0C Page C-1 

*** COMPANY CONF - DEC Internal Use Only 18 -Mar -1985 


VIDEO SYSTEMS REFERENCE MANUAL 
Product Reference 

Document Identifier: A-DS -EL0007 0 - ,0C- 0 Rev. AXll, 18-Mar-1985 


ABSTRACT: This appendix describes the products which have been 

certified as conforming to the architecture defined in the Video 
Systems Reference Manual, and identifies any areas in which those 
products deviate from the architectural specifications. 


APPLICABILITY: SARA Formal Cross - Component Standard. Mandatory - 

for Engineers designing hardware for terminal products and 
Software Engineers designing programs using terminal interfaces. 
Additional requirements are defined in the section on "Concepts 
and Conformance Criteria". 


STATUS: FOR REVIEW ONLY 
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j This document has been placed in the SARA "Formal I 

I Cross - Component Standard" category. The material contained I 

I within this document is assumed' to define mandatory standards 
I unless it is clearly marked as (a) not mandatory or 
I (b) guidelines. Material which is marked as "not mandatory" is i 
I considered to be of potential benefit to the corporation and I 
I should be followed unless there are good reasons for 
I non-compliance. "Guidelines" define approaches and techniques .*! 
j which are considered to be good practice, but should not be 
I considered as requirements. The procedures for modifying or 
i evolving this standard are contained within the contents of 
I this document. 
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C.l Product/Architecture Matrix 

The following table describes the products which are currently 
certified or planning to be certified as conforming to the Video 
Systems Reference manual in accordance with the conformance 
requirements described the chapter "Conformance Requirements". 
Products which are planned to be certified but have not yet been 
tested are indicated by an asterisk (*). 


D R 

E A V 

C l A 

P M N X 

R A B S 

0 T 0 T 

V V F E W A 

T T 

2 2 E E E I 

2 4 X X X N 

0 0 T T T T 

+ 

LEVEL— 1- ! X X X X X 

+ 

LEVEL 2 ! X X X 

+ 

********** EXTENS IONS ********** 

+ - 

132 COLUMNS ! X X XX 

+ 

PRINTER PORT ! X X 


REGIS GRAPHICS! *X 

+ 

SIXEL GRAPHICS! X 

+ 

DRCS ! X X 

+ - 

UDK I X X 

+ -- 

********** OPTIONS ********** 

+ 

! 

+ 


VT52 


X 


X 
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C.2 Rainbow lOOA Computing Terminal / 07-JAN-83 

The Certification Waiver Panel met on 22-DEC-82 to review the 
results of RAINBOW Certification. Each deviation that was listed 
in the Certification Report of 20-DEC-82 was discussed and 
agreement was reached in every instance as to how the deviations 
would be resolved. Because of this, the opinion of the Waiver 
Panel is that RAINBOW has PASSED CERTIFICATION WITH WAIVERS as a 
Level 1 Device. 

Many waivers were granted on the basis that the product would be 
changed to eliminate the deviations between it and the 
architecture (see section 1.0 below). In some cases, the changes 
are scheduled for the first or second planned ECO release, but in 
all cases, a commitment was made to fix the problems by the next 
generation release. 

Because only part of DEC Standard 169 was implemented, and some 
problems exist with this and other Level 2 issues, a restriction 
is placed on the advertising of this product. Examples of the 
partial/incorrect implementation of DEC Standard 169 are: 

- G2 and G3 character set designators parse incorrectly 

- DEC Supplemental Character Set was unavailable. 

These are Level 2 issues, however, and as such do not effect Level 
1 Certification results. Advertising compatibility with either 
DEC Standard 169 or DEC Multinational is not to be allowed, but 
advertising the fact that a subset of DEC Multinational is 
available may be acceptable. 

What follows is a list of the actual deviations placed in the 
categories as a result of the Waiver Panel meeting. The list is 
included here in order to document what changes were agreed upon 
in order to gain agreement that RAINBOW may be called a Level 1 
product . 
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CATEGORY 1 : CHANGE THE PRODUCT 

For items in this category, it is agreed that the problem must be 
fixed, but that because plans are in place to do so by a specified 
time, a waiver is granted. 


1) <BS> - Backspace 

If the screen is set to 132 column mode and the cursor is 
positioned beyond column 127, the reception of the backspace 
control will position the cursor to the left margin. 


2) <ESC> [ 2 h - Keyboard-action locked; 

When Keyboard Action mode is set while a key is auto repeating, 
the WAIT indicator lights but the codes do not stop until the key 
is released. Then no new codes are generated. If KAM is reset 
while a key is down, no codes are generated until after the key is 
released. Further, when the keyboard is locked, the break key 
does not function. 


3) Relative Cursor Positioning 

When using relative cursor positioning (cursor down or cursor 
forward) a parameter greater than 255 will cause the cursor to 
disappear . 


4) Auto repeating 

If a control key is pressed before a non-control key, auto 
repeating is suppressed after the control key is released. A key 
pressed before the control key causes the the control code to be 
repeated after control is pressed. 


5) Undefined Character Codes 

RAINBOW displays undefined character codes as upside down question 
marks . 
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CATEGORY 2: CHANGE THE ARCHITECTURE 

For items in this category, it is agreed that the product was 
implemented in a reasonable fashion and the architecture may need 
clarification. 


1) SETUP 

Entering SETUP resets keyboard action mode and turns off keyboard 
locked indicator. The architecture will be changed to state that 
entering and exiting SETUP should not change keyboard action mode 
unless the user has explicitly executed a function from within 
SETUP that unlocks the keyboard. 


2) Error Bells 

The following keys produced key clicks instead of error bells when 
pressed with control; EOl, E09, ElO, Ell, E12, CIO, Cll, BOO, 

B08, B09. 
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CATEGORY 3: CHANGE THE CERTIFICATION PROCESS 

For items in this category, it is agreed that the certification 
process was in error in that it either failed to properly 
interpret the architecture or failed to properly test the product. 


1) <ESC> V - Print-Cursor-Line: 

No car riage - return and line feed are appended to the line when 
performing a print cursor line. 


2) Dead Keys 

Inappropriate error bells are sounded when the following keys are 
depressed: El, E2 , E3, E4, E5, E6 , F6 , F8 , F9 , FIO, F14, F15, 

F16, F17, F18, F19, F20, Compose. These are specified as dead 
keys by the SRM. 
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CATEGORY 4; WAIVE BY AGREEMENT OF THE PANEL 

Por items in this category, it is agreed that no change is to be 
made at this time to the product, the architecture or the 
certification procedures. By granting this waiver, the Panel is 
expressing the opinion that it considers the issue insufficient 
cause for the product to fail certification. 


1) <ESC> c - Reset to initial state; 

RIS fails to accomplish a complete reset. Note: RIS is not a 
recommended sequence to execute. 


2) <ESC> [ ? 7 h - Auto wrap on. 

Auto wrap operates like the VT102 (not considering interdependent 
sequences) but the VT102 does not conform to the TIA Video SRM. 


3 ) XON/XOFF 

When the key combination Cntrl/S- is sent, RAINBOW sends XOFF to 
the host. No other effect appears until the input buffer is 
tested while RAINBOW is in SET-UP or Hold Screen mode. At this 
time the buffer stores 235 characters before sending XOFF to the 
host. However, when RAINBOW exits SET-UP or Hold Screen mode, the 
screen updates using the buffered data, but RAINBOW does not send 
XON to the host. After the terminal is reset with Cntrl/SET-UP 
(or typed Cntrl/Q), the buffer holds 157 characters before sending 
XOFF and sends XON when the screen is updated. 


4) SHIFT & LOCK 

If control is pressed with both shift and lock set no code is 
generated when a code generating key is then pressed. 


5 ) CONTROL 

The following keys did not produce any codes when pressed with 
control: EDO, E02, E03, E04, E05, E06, E07, EOS, BlO. 


6) <ESC> [ p K , <ESC> [ p J - Erase in line / Erase in display. 

The RAINBOW escape sequences for erase in line and erase in 
display only processes the first selective parameter if more than 
one is sent. 
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7) ABORT <ESC> SEQUENCE 

When escape sequence parsing aborts, it does so in such a way that 
subsequent characters are printed rather than suppressed. 

8) Shift Lock Mode 

Shift Lock mode is unavailable. 

9) COMPOSE KEY 

The compose key beeped instead of producing 7 -bit compose sequence 
codes. 


10) PHYSICAL CONNECTORS 

The female DB-25 connector on the back of the RAINBOW is not 
compatible with the VT102 printer port male DB-25 connector. 
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CATEGORY 5: RESTRICT 

For items in this category, it is agreed that although no change 
to the product is involved at this time, the deviation is serious 
enough to warrant placing a restriction on what compatibility or 
other claims the product should be allowed to make. 


There were no items in this category. 


CATEGORY 6; NO RESOLUTION 

For items in this category, the Waiver Panel was unable to agree 
on a resolution for the issue or on the proposed time frame for 
resolution, and will present it to upper management for a 
decision. 


There were no items in this category. 
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C.3 DECmate II Word Processing Station / 20-JAN-83 

The Certification Waiver Panel met on lO-JAN-8.3 to review the 
results of DECMATE II Certification. Each deviation that was 
listed in the Certification Report of 06-JAN-83 was discussed and 
agreement was reached in every instance as to how the deviations 
would be resolved. Because of this, the opinion of the Waiver 
Panel is that DECMATE II has PASSED CERTIFICATION WITH WAIVERS as 
a Level 1 Device. 

Many waivers were granted on the basis that the product would be 
changed to eliminate the deviations between it and the 
architecture (see section 1.0 below). In some cases, the changes 
are scheduled for the first or second planned ECO release, but in 
all cases, a commitment was made to fix the problems by the next 
generation release. 

Because only part of DEC Standard 169 was implemented, and some 
problems exist with this and other Level 2 issues, a restriction 
is placed on the advertising of this product. Examples of the 
partial/incorrect implementation of DEC Standard 169 are: 

- COMPOSE is not functional. 

- DEC Supplemental Character Set is not available in a way 
compatible with DEC Standard 169. 

- Function key codes are transmitted from the Level 1 terminal 
emulation package. 

It was agreed that because of these issues, advertising 
compatibility with either DEC Standard 169 or DEC Multinational is 
not to be allowed. It was further agreed that when DECMATE II 
implements Level 2 it will no longer be possible to access Level 2 
features from Level 1. As a result, these issues will not impact 
Level 1 Certification results. 

What follows is a list of the actual deviations placed in 
categories as a result of the Waiver Panel meeting. The list is 
included here in order to document what changes were agreed upon 
in order to gain agreement that DECMATE IT may be called a Level 1 
product . 
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CATEGORY 1 : CHANGE THE PRODUCT 

For items in this category, it is agreed that the problem must be 
fixed, but that because plans are in place to do so by a specified 
time, a waiver is granted. 


1) <ESC> # 8 Screen Alignment 

Sometimes when <ESCi> # 8 is sent, the screen alignment grid 
pattern is not displayed until some additional character or escape 
sequence is sent. On other occasions, this works properly. 


2) <ESC> # 3, <ESC> # 4, <ESC> # 6 Line Attributes 

1. When a command is sent to set a line to Single-Height 
Double-Width characters, no change takes place until a 
character or escape is sent to the screen. 

2. An attempt to set a line attribute in a line followed by 
a carriage return/line feed does not set the attribute 
for that line but sets it instead for the next line and 
then only if a character or escape is sent on that line. 

3. The sequence <ESC>[H <ESC>#6 <CRLF> <ESC>#6 fails to set 
the proper line attribute for line one. Similarly for 
other line attributes. 

4. When followed by a test string loses characters in 
columns 31 to 40 and displays the characters from a 
subsequent line. 

5. When followed by a tab fails to display subsequent 
characters output to the line. 


3) <ESC> [ ? 15 n - Request Printer Status 

DECmate II does not respond to the request for printer status. 


4) <ESC> [ c - Device Status Report 

DECMATE II responds with <ESC>[?l;2c indicating it is a VTlOO 
rather than a a LEVEL 1 device. Since the DECMATE II emulates a 
VT102 rather than a VTlOO it should respond as VT102 until 
software is prepared for the LEVEL 1 response. 


5) <ESC> [ 2 h - Keyboard Action Mode 
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Keyboard action mode turns off the keyboard including local 
function keys. However, key clicks do not stop for 4 more 
keystrokes. When the keyboard is unlocked, the 4 codes are 
transmitted. Because the local function keys are locked, the only 
way to turn the keyboard back on is with another control sequence. 


6) Parser Error Processing 

The parser does not always process error conditions properly. For 
example, if the sequence <ESC>[[[[( is sent, the extraneous "["'s 
are not displayed. In some cases, it gets so confused that a 
<CAN> is required to bring it to life. 


7) Default modes 

The emulator starts up with the alternate keypad in application 
mode instead of numeric mode, and cursor keys in application mode 
instead of cursor mode. 


8) <DEL> Processing 


If a <DEL> is embedded in an ESCAPE sequence, the sequence is 
aborted. <DEL> should be ignored in this context. 


9) Control S, Control Q processing 

E02, DOl and C02 produce no codes when held with Control. This 
also relates to special processing associated with "\" . 

10) Function key processing. 

The function keys other than delete do not autorepeat. 


11) Keyboard response. 

All keys click even for invalid combinations, and no error bell 
sounds for invalid combinations. 


12 ) Legend Strip 

The SET UP, BREAK, and blank key indications on the legend strip 
are incorrect. 
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CATEGORY 2: CHANGE THE ARCHITECTURE 

For items in this category, it is agreed that the product was 
implemented in a reasonable fashion and the architecture may need 
clarification. 


1) Answerback and disconnect by Control. 

CONTROL/BREAK (answerback) and SHIFT/BREAK (disconnect) transmit 
break. Requirements in the architecture to be changed based on K. 
House memo to R. Sudama. 



VSRM - Product Reference EL-00070-0C Page C-16 

*** COMPANY CONF - DEC Internal Use Only 18 -Mar -1985 

CATEGORY 3: CHANGE THE CERTIFICATION PROCESS 

For items in this category, it is agreed that. the certification 
process was in error in that it either failed to properly 
interpret the architecture or failed to properly test the product. 

1) XON processing 

When returning to the WPS menu, DECMATE II sends XON to the host. 

2) SET-UP 


SET-UP is not available from the terminal emulator. 
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CATEGORY 4: WAIVE BY AGREEMENT OF THE PANEL 

For items in this category, it is agreed that no change is to be 
made at this time to the product, the architecture or the 
certification procedures. By granting this waiver, the Panel is 
expressing the opinion that it considers the issue insufficient 
cause for the product to fail certification. 


1) "\" (Backslash) 

"\" does not transmit a code on alternate pressings. That is to 
say if two backslashes are pressed only the second is transmitted. 

This is related to the \R, mechanism for returning to WPS from CX 
mode. It is not clear why the terminal, having realized "\R" has 
not been been entered, cannot send both codes. 


2) Transmission Rate 

The transmission rate is not limited to 240 CPS. This may cause 
problems for some operating systems. 
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CATEGORY 5: RESTRICT 

For items in this category, it is agreed that although no change 
to the product is involved at this time, the deviation is serious 
enough to warrant placing a restriction on what compatibility or 
other claims the product should be allowed to make. 


There were no items in this category. 


CATEGORY 6: NO RESOLUTION 

For items in this category, the Waiver Panel was unable to agree 
on a resolution for the issue or on the proposed time frame for 
resolution, and will present it to upper management for a 
decision. 


There were no items in this category. 
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C.4 Professional Computing Terminal / 20-APR-83 

The Certification Waiver Panel met on'31-JAN-83 to review the 
results of PRO 350 Certification. Each deviation that was listed 
in the Certification Report of 24-JAN-83 was discussed and 
tentative agreement was reached in every instance as to'how the 
deviations would be resolved. 

In the weeks that followed, upper management was made aware of 
these decisions and has not objected to any of them. Some waivers 
were granted on the basis that the product would be changed to 
eliminate the deviations between it and the architecture. In all 
cases, a commitment was made to fix the problems by the next 
generation release. Because of this, the opinion of the Waiver 
Panel is that the PRO 350 has PASSED CERTIFICATION WITH WAIVERS as 
a Level 1 Device. 

It is important to note that although the product has implemented 
many Level 2 features, specifically those that pertain to DEC 
Standard 169, we have not attempted to certify at Level 2. Since 
the Certification group has not tested DEC Standard 169 or DEC 
Multinational, the group is not yet prepared to make a statement 
about the product's compatibility with those standards. 

What follows is a list of the actual deviations placed in 
categories as a result of the Waiver Panel meeting. The list is 
included here in order to document what changes were agreed upon 
in order to gain agreement that the PRO 350 may be called a Level 
1 product. 



VSRM - Product Reference EL-00070-OC Page C-20 

*** COMPANY CONF - DEC Internal Use Only 18-Mar-1985 


CATEGORY 1 : CHANGE THE PRODUCT 

For items .in this category, it is agreed that the problem must be 
fixed, but that because plans are in place to do so by a specified 
time, a waiver is granted. 


1) <ESC> [7 8 h - Autorepeat 

The function keys Backspace, Linefeed, and Tab do not autorepeat. 
The architecture states that all keys except RETURN should 
autorepeat. 


2) <ESC> [ c - Device Attribute Report 

PRO 350 responds with <ESC> [ ?12 ; 7 ; 0 ; 1 02c which is not the proper 
response for a LEVEL 1 device. Since software currently does not 
support the architectural identification scheme, it is agreed that 
certain device specific responses would be correct: 

A) If the emulator is in PRO mode; 

CSI723 ; 1 ; 0 ; 0 ; Oc (if EBO installed) 

CSI?23;0;O;0;0c (if no EBO) 

B) If the emulator is in VT125 mode: 

ESC [ ?12 ; 7 ; 0 ; 102c (will alwa.ys be ESC not CSI) 

C) If the emulator is in VT102 mode: 

ESC[ ?6c 

D) If the emulator is in VT52 mode: 

ESC\Z 


3 ) Break Key 

The Break key sends <BREAK> when pressed alone, or when pressed 
together with either shift or with control. Shift Break should be 
disconnect and Control Break should be answerback. Since 
answerback is not programmable in this product, control break 
should cause no code to be sent. 


4 ) TAB 

When auto wrap mode is set, the Horizontal Tab does not reset the 
LAST -COLUMN -FLAG. 
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5) <ESC> \ - String Terminator 

ST is not handled properly with the control strings OSC (Operating 
System Command), DCS (Device Control String), APC (Application 
Program Command) and PM (Privacy Message). ST will only terminate 
the "<ESC>Pp" ReGIS control string, and it is inoperative for the 
others. 
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CATEGORY 2: CHANGE THE ARCHITECTURE 

For items in this category, it is agreed that the product was 
implemented in a reasonable fashion and the architecture may need 
clarification. 


1) <ESC> [ ? 8 h - Autorepeat 

If auto repeat is turned off by a control function while a key is 
auto- repeating, two keystrokes worth of codes are transmitted. 

This is a timing issue, and the architecture will change to 
eliminate a specified requirement for the delay between receipt of 
autorepeat and when the function takes effect. 


2) Answerback 


Answerback message is not 
changed to put Answerback 
"exceptions". This means 
required for conformance, 
certifications . 


supported. The architecture will be 
into an appendix of documented 
that the function will no longer be 
and it will not be tested in future 


3) <ESC> [ ? 7 h - Auto Wrap 

When auto wrap mode is set. Erase in Display resets the LAST- 
COLUMN-FLAG, but according to the TIA specification it should not. 
The architecture was in error in this matter, and will be changed 
to require both Erase in Line and Erase in Display to reset the 
LAST - COLUMN - FLAG . 
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CATEGORY 3: CHANGE THE CERTIFICATION PROCESS 

For items in this category, it is agreed that the certification 
process was in error in that it either failed to properly 
interpret the architecture or failed to properly test the product. 


1) <ESC> [ Pn @ - Insert Character 

The Certification group reported that Insert Character was not 
implemented. After the problem was reported, the architecture was 
changed to no longer require this implementation in Level 1 but to 
require it for Level 2, and therefore the testing procedures will 
have to follow suit. 
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CATEGORY 4: WAIVE BY AGREEMENT OF THE PANEL 

For items in this category, it is agreed that no change is to be 
made at this time to the product, the architecture or the 
certification procedures. By granting this waiver, the Panel is 
expressing the opinion that it considers the issue insufficient 
cause for the product to fail certification. 


1) <ESC> ( 2 h - Keyboard Action Mode 

Keyboard Action Mode is turned off whenever SET-UP is entered and 
exited. 


2) Key Processing 

The El - E5, F6 - FlO, and F14 - F20 keys do not output codes but 
do click. They should not click. 


3) <ESC> [5m- Blink 

Fields with the blink attribute do not always blink. This occurs 
when more than 100 fields are set to blink simultaneously. 


4) <ESC> c - Reset 


RIS does not control the setting of Auto Wrap mode. 



VSRM - Product Reference EL-00070-0C Page C-25 

*** COMPANY CONF - DEC Internal Use Only 18-Mar-1985 


CATEGORY 5: RESTRICT 

For items in this category, it is agreed that although no change 
to the product is involved at this time, the deviation is serious 
enough to warrant placing a restriction on what compatibility or 
other claims the product should be allowed to make. 


There were no items in this category. 


CATEGORY 6 : NO RESOLUTION 

For items in this category, the Waiver Panel was unable to agree 
on a resolution for the issue or on the proposed time frame for 
resolution, and will present it to upper management for a 
decision. 


There were no items in this category. 
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i . C.5 VT240/VT241 Terminal / 14-NOV-83 

i 

I 

The Certification Waiver Panel met on ll-NOV-83 to review the 
I results of VT240/VT241 Certification. Each deviation that was 
i listed in the Certification Report of lO-NOV-83 was discussed and 
j agreement was reached in every instance as to how the deviations 
I would be resolved. Because of this, the opinion of the Waiver 

j Panel is that VT240/VT241 has PASSED CERTIFICATION WITH WAIVERS as 

I a Level 2 Device, 
i 

I One waiver was granted on the basis that the product would be 

I changed to eliminate the deviations between it and the 

t architecture (see section 1.0 below). A commitment was made to 
! fix the problem by the next generation release. 

I 

I 

! What follows is a list of the actual deviations placed in the 
1 categories as a result of the Waiver Panel meeting. The list is 

j included here in order to document what changes were agreed upon 

I in order to gain agreement that the VT240/VT241 may be called a 
I Level 2 product. 
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CATEGORY 1: CHANGE THE PRODUCT 

For items in this category, it is agreed that the problem must be 
fixed, but that because plans are in place to do so in a future 
release, a waiver is granted. 


1) Insert Line / Delete Line 

Attempting to INSERT or DELETE a line while the cursor is 
positioned below the bottom margin should be ignored by the 
terminal. The VT240 will crash if this is attempted. Due to the 
fact that this attempt would normally be ignored, software should 
avoid this condition. 
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CATEGORY 2: CHANGE THE ARCHITECTURE 

For items in this category, it is agreed that the product was 
implemented in a reasonable fashion and the architecture may need 
clarification . 


I 1) EXIT VT52 MODE leaves the terminal in LEVEL 1. 

I 

I Sending the escape sequence to EXIT VT52 MODE will leave the 

I terminal in LEVEL 1 mode even if the terminal had been set to 

I LEVEL 2 mode prior to entering VT52 mode. The architecture will 
I be changed to reflect this functionality. 
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CATEGORY 3: CHANGE THE CERTIFICATION PROCESS 

For items in this category, it is agreed that the certification 
process was in error in that it either failed to properly 
interpret the architecture or failed to properly test the product. 


There were no items in this category. 
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CATEGORY 4; WAIVE BY AGREEMENT OF THE PANEL 

For items in this category, it is agreed that no change is to be 
made at this time to the product, the architecture or the 
certification procedures. By granting this waiver, the Panel is 
expressing the opinion that it considers the issue insufficient 
cause for the product to fail certification. As noted in the 
descriptions below the panel reccomends that certain of these be 
considered for fix in a future release of the product. 


1) Pressing or Releasing SHIFT can cause multiple returns to be 
sent. 

If the SHIFT key is pressed or released while the RETURN key is 
held down, a RETURN code will be transmitted, by the terminal. 
This is a problem with the JLK201 that cannot be solved by the 
terminal firmware. 


2) ESC or CSI embedded in escape sequences is not always handled 
correctly. 

The SRM calls for-HESC and CSI to abort escape sequences in 
progress. If an ESC or CSI is sent to the terminal during the 
processing of a DEC PRIVATE control sequence, the sequence is not 
always aborted correctly. Attempts were made to fix this problem, 
but Certification testing was unable to verify that all instances 
of this problem had been corrected. Attempts will be made to both 
fix and test the problem in a future release. 


3) LEVEL 2 parameters to SELECT GRAPHIC RENDITION (SGR) are valid 
in LEVEL 1 . ’ 

The SRM specifies that SGR parameters 22, 24, 25, and 27 are LEVEL 2 
functions. If LEVEL 2 SGR parameters are sent to the terminal 
while in LEVEL 1 mode, they will be acted upon. Due to the 
possibility of causing product compatiblity problems, the product 
will not be required to change the implementation in a future 
release. Software should not depend on these functions working in 
LEVEL 1, as other implementations will function as specified. 


4) DECUDK allows keys to be downloaded in LEVEL 1. 

The DECUDK control is specified to be a LEVEL 2 function. The 
terminal allows the function keys to be downloaded, but the keys 
are inactive until the terminal is placed into LEVEL 2 mode. Due 
to the possibility of causing compatiblity problems, the product 
will not be required to change the implementation in a future 
release. Software should not depend on these functions working in 
LEVEL 1, as other implementations will function as specified. 
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5) Device Status Request(DSR) for UDK Lock status works in LEVELl . 

The DSR for UDK Lock status is specified to be a LEVEL 2 function. 
I The terminal repsonds to the request while the terminal is 
I operating in LEVEL 1 mode. Due to the possibility of causing 
I compatiblity problems, the product will not be required to change 
I the implementation in a future release. Software should not 
I depend on these functions working in LEVEL 1, as other 
I implementations will function as specified, 
i 

1 6) DECTCEM works in LEVEL 1. 

i 

I The DECTCEM control is specified to be a LEVEL 2 function. The 
terminal allows the cursor to enabled/disable while the terminal 
I is operating in LEVEL 1. Due to the possibility of causing 
j compatiblity problems, the product will not be required to change 
1 the implementation in a future release. Software should not 
depend on these functions working in LEVEL 1, as other 
i implementations will function as specified. 

j 7) Character 10/0 goes to the printer as SUB. 

I 

I The SRM specifies the code 10/0 shall be sent to the printer as 
I UNDERSCORE. The terminal currently sends the SUB code to the 
1 printer. Attempts will be made to fix the problem in a future 
I release. 


j 8) Undefined characters from GR are sent to the printer • 

I incorrectly. 

I 

! The SRM specifies that undefined multinational codes be sent to 
i the printer as UNDERSCORE. The terminal sends the character code 
to the printer instead of the underscore character. DEC printers 
that support DEC Multinational will correctly print the codes as 
'REVERSE QUESTION MARK'. Attempts will be made to fix the problem 
in a future release. 


j 9) IF DEC supplemental is in GL, SPACE is printed as 10/0. 

i Use of DEC supplemental in this way is prohibited by DEC Standard 
! 169. The cosequences of the terminal behavior are not fully 

understood. Attempts will be made to fix the problem in a future 
release. 
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CATEGORY 5; RESTRICT 

For items in this category, it is agreed that although no change 
to the product is involved at this time, the deviation is serious 
enough to warrant placing a restriction on what compatibility or 
other claims the product should be allowed to make. 


There were no items in this category. 


CATEGORY 6: NO RESOLUTION 

For items in this category, the Waiver Panel was unable to agree 
on a resolution for the issue or on the proposed time frame for 
resolution, and will present it to upper management for a 
decision. 


There were no items in this category. 
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C.6 VAXstation Workstation / lO-JUL-84 

The Certification Waiver Panel met on lO-JUL-84 to review the 
results of VAXstation Certification. Each deviation that was 
listed in the Certification Report of lO-JUN-84 was discussed and 
agreement was reached in every instance as to how the deviations 
would be resolved. Because of this, the opinion of the Waiver 
Panel is that VAXstation has PASSED CERTIFICATION WITH WAIVERS as 
a Level 2 Device. 

Ten waivers were granted on the basis that the product would be 
changed to eliminate the deviations between it and the 
architecture (see CATEGORY 1 below). A commitment was made to fix 
the problem by the next generation release. 

What follows is a list of the actual deviations placed in the 
categories as a result of the Waiver Panel meeting. The list is 
included here in order to document what changes were agreed upon 
in order to gain agreement that the VAXstation may be called a 
Level 2 product. 
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CATEGORY 1; CHANGE THE PRODUCT 

For items in this category, it is agreed that the problem must be 
fixed, but that because plans are in place to do so in a future 
release, a waiver is granted. 

1. There is no implementation of the BLINK graphic 
rendition. (fix planned for update release) 

2. <ESC>[?8h or <ESC>[?81 will not set or reset auto repeat 
Auto repeat is set via user profile, allowing it session 
wide. (fixed planned for , January 1985 release) 

3. SUB does not have a representation in Level 1 mode. It 
correctly displays the backward question mark in Level 2 
mode. (fix planned for update release) 

4. If the terminal is set to Level 2, 8 bit controls (via 
S8C1T), and then Level 1 is selected (via DECSCL), the 
terminal is not reset to 7 bit controls. The Arrow keys 
and the Keypad Function keys still send 8 -bit codes. 

(fix planned for update release) 

— 5-.- With New Line Mode set, ENTER sends CR instead of CR LF 
and CTRL/M sends CR LF instead of CR. (fix planned for 
update release) 

6. A Level 2 VT52 configuration is possible. This occurs if 
VT52 mode is selected on a 7-bit terminal (via terminal 
settings), and then the 8-bit multinational terminal 
setting is selected. Everything about the Level 2 VT52 
is like a normal VT52, with the exception of the 
keyboard, which sends Level 2 codes for the Arrow keys 
and the Keypad Function keys. (fix planned for update 
release ) 

7. SHIFT/CAPS LOCK mode is not implemented. (fixed planned 
for v2.0, January 1985 release) 

8. According to the SRM, ANSWERBACK should be a minimum of 
20 characters for a Level 1 device and 30 characters for 
a Level 2 device. On the vaxstation, a maximum of 20 
characters are allowed, the number depending on the size 
of the character. Therefore, most of' the time, less than 
20 characters must be used in answerback. (fix planned 
for update release) 

KAM (keyboard acti'on mode) sequences are ignored. The 
keyboard cannot be locked/unlocked with the ESC[ 2h/ESC[ 21 
sequences. (fix planned for V2 . 0 January 1985 release) 


9 . 
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CATEGORY 1: CHANGE THE PRODUCT (cont'd) 


10. If a key is held down and is autorepeating (a, for 

example), and then CTRL is held down the autorepeating 
stops, and the appropriate control code (CTRL/A in this 
instance) may OR may not be sent. Release of the CTRL 
key results in continuation of autorepeat of the original 
character (a). (fix planned for update release) 
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CATEGORY 2: CHANGE THE ARCHITECTURE 

For items in this category, it is agreed that the product was 
implemented in a reasonable fashion and the architecture may need 
clarification . 


There were no items in this category. 


CATEGORY 3: CHANGE THE CERTIFICATION PROCESS 

For items in this category, it is agreed that the certification 
process was in error in that it either failed to properly 
interpret the architecture or failed to properly test the product. 


There were no items in this category. 
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CATEGORY 4 : WAIVE BY AGREEMENT OF THE PANEL 

For items in this category, it is agreed that no change is to be 
made at this time to the product, the architecture or the 
certification procedures. By granting this waiver, the Panel is 
expressing the opinion that it considers the issue insufficient 
cause for the product to fail certification. As noted in the 
descriptions below the panel reccomends that certain of these be 
considered for fix in a future release of the product. 

1. SCROLLING MODE can not be altered, therefore <ESC>[?4h or 
<ESC>[?41 are ignored. Smooth scroll is not supported on 
the Vaxstation. 

2. Invalid control combinations and dead keys (F6-F10, F14, 
F17-F20, E1-E6 in Level 1) keyclick. They should not. 

3. The TAB key does not autorepeat. It should. 
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CATEGORY 5: RESTRICT 

For items in this category, it is agreed that although no change 
to the product is involved at this time, the deviation is serious 
enough to warrant placing a restriction on what compatibility or 
other claims the product should be allowed to make. 


There were no items in this category. 


CATEGORY 6: NO RESOLUTION 

For items in this category, the Waiver Panel was unable to agree 
on a resolution for the issue or on the proposed time frame for 
resolution, and will present it to upper management for a 
decision. 


There were no items in this category. 
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C.7 VT220 Video Terminal / 27-Oct-84 

! The Certification Waiver Panel met on 17-Jul-84 to review the 
1 results of VT220 Certification. Each deviation that was listed in 
I the Certification Report of 2-JUL-84 was discussed and agreement 
[ was reached in every instance as to how the deviations would be 
i resolved. Because of this, the opinion of the Waiver Panel is 

1 that VT220 has PASSED CERTIFICATION WITH WAIVERS as a Level 2 
I Device. 

I Five waivers were granted on the basis that the product would be 
I changed to eliminate the deviations between it and the 
i architecture (see page C-2 ). A commitment was made to fix the 
! problem should there be a next generation release. 

I What follows is a list of the actual deviations placed in the 
I categories as a result of the Waiver Panel meeting. The list is 
I included here in order to document what changes were agreed upon 
j in order to gain agreement that the VT220 may be called a Level 2 
! product. 
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CATEGORY 1 : CHANGE THE PRODUCT 

For items in this category, it is agreed that the problem must be 
fixed, but that because plans are in place to do so in a future 
release, a waiver is granted. 

1. CTRL-M transmits CR LF rather than CR when new line mode 
is set. 

2. Erase in Display from beginning of display to active 
position does not reset the line to single width when 
sent from the last column of' a double width line. 

3. One compose sequence for the \ (backslash) charactex, 
while using the UK keyboard in NRC mode, is missing. 

This ' sequence is COMPOSE / / . The other two sequences 
for backslash (COMPOSE / < and COMPOSE < /) are present.. 

4. If a character other than a valid character is included 
within a DECUDK sequence, the key definition involved may 
be ignored, depending upon the position of this character 
within the definition. If the character is within the 
"Kyn" portion of the definition (before the "/" ) / that 
key's definition is ignored. If the character appears 
after the "/" » the bad character is ignored and the 
definition is assigned correctly. The SRM states that 
the result of including any invalid characters is 
undefined, but recommends that these characters be 
ignored for future compatibility. 

5. When the terminal is set to eight bit printer port, the 
VT220 translates ESC Fe sequences to 8 bit CSI's rather 
than passing the 7 bit ESC['s. The terminal should pass 
the '7 bit ESC*[ . 
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1 CATEGORY 2: CHANGE THE ARCHITECTURE 

i For items in this category, it is agreed that the product was 
I implemented in a reasonable fashion and the architecture may need 
1 clarification. 


I 2. Top row function keys (F6-F20) are inoperative when pressed 
I with the CTRL key and Editing keys (Find, Insert Here, etc.) are 
I inoperative when pressed with either the SHIFT or CTRL keys. 

I The architecture currently states that these keys should not be 
I affected by CTRL and/or SHIFT. It will be changed to reflect that 
I the keys should be inoperative when pressed with CTRL and/or 

I SHIFT. 

1 3. Select Graphic Rendition allows Level 2 parameters (22, 24, 

! 25, 27) in Level 1 mode. 

i 

I The architecture will be changed to include a statement that Level 
I 2 parameters (22, 24, 25, 27) may be recognized in level 1 mode, 

I but that conforming software shall not rely on this feature. 

I 

I 4. According to the SRM, "Only the U.S. keyboard provides 
i alternative forms for keying the CO controls...". The VT220 
I provides the alternative forms on all of the foreign keyboards, 
i where applicable . 

I A statement will be added to the architecture to clarify that 
j these alternate forms are provided on non-US keyboards whenever 
i the keys involved in these control combinations are present. 

i 5. There are 2 additional compose sequences which are not 

included in the SRM, but are implemented by the terminal. They 
j are: Section Symbol - Compose S! Compose IS, and Backslash - 
i Compose /< and Compose </. 

j 

j These control sequences will be added to the architecture. 

I 

I 

j 6. In VTIOO mode, multinational, with British keyboard, typing 
I the British pound key generates and displays "#". This key should 
I be dead in level 1 mode since it represents an 8 bit DEC 
i Supplemental character. 

j 

: The architecture will indicate that there is an exception to this 

i rule for the British keyboard. 
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CATEGORY 3: CHANGE THE CERTIFICATION PROCESS 

For items in this category, it is agreed that the certification 
process was in error in that it either failed to properly 
interpret the architecture or failed to properly test the product. 


There were no items in this category. 
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CATEGORY 4: WAIVE BY AGREEMENT OF THE PANEL 

For items in this category, it is agreed that no change is to be 
made at this time to the product, the architecture or the 
certification procedures. By granting this waiver, the Panel is 
expressing the opinion that it considers the issue insufficient 
cause for the product to fail certification. As noted in the 
descriptions below the panel reccomends that certain of these be 
considered for fix in a future release of the product. 

1. Pressing or Releasing SHIFT can cause multiple returns to 
be sent. 

. If the SHIFT key is pressed or released while the RETURN 
key is held down, a RETURN code will be transmitted by 
the terminal. This is a problem with the LK201 that 
cannot be solved by the terminal firmware. 

2. Under some circumstances more than one BELL ring occurs 
when there should only be one. 

Again, this is a problem with the LK201 that cannot be 
solved by the terminal firmware. 

3. Text Cursor Enable Mode (TCEM) is allowed in Level 1 
mode . 

The DECTCEM control is specified to be a. LEVEL 2 
function. The terminal allows the cursor to 
enabled/disable while the terminal is operating in LEVEL 
1. Due to the possibility of causing compatiblity 
problems, the product will not be required to change the 
implementation in a future release. Software should not 
depend on these functions working in LEVEL 1, as other 
implementations will function as specified. 
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CATEGORY 5: RESTRICT 

For items in this category, it is agreed that although no change 
to the product is involved at this time, the deviation is serious 
enough to warrant placing a restriction on what compatibility or 
other claims the product should be allowed to make. 


There were no items in this category. 


[ CATEGORY 6: NO RESOLUTION 

I 

I For items in this category, the Waiver Panel was unable to agree 
i on a resolution for the issue or on the proposed time frame for 
i resolution, and will present it to upper management for a 
i decision. 


I 

I 

There were no items in this category. 
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VIDEO SYSTEMS REFERENCE MANUAL 
Documented Exceptions 

Document Identifier: A- DS - EL00070 - OD- 0 Rev. AXll, 18-Mar-1985 


ABSTRACT: This appendix contains the specification of terminal 

features which are considered exceptions to the architecture. As 
exceptions, they are not required of conforming hardware 
implementations, and will not be used by conforming software. 
However, when implemented, they should be implemented according to 
this standard in order to insure consistency of behavior across 
products. 

APPLICABILITY: SARA Formal Cross - Component Standard. Mandatory 

for Engineers designing hardware for terminal products and 
Software Engineers designing programs using terminal interfaces. 
Additional requirements are defined in the section on "Concepts 
and Conformance Criteria". 


STATUS: FOR REVIEW ONLY 


+ + 

I This document has been placed in the SARA "Formal | 

I Cross - Component Standard" category. The material contained | 

I within this document is assumed to define mandatory standards | 

! unless it is clearly marked as (a) not mandatory or | 

I (b) guidelines. Material which is marked as "not mandatory" is | 

I considered to be of potential benefit to the corporation and I 
! should be followed unless there are good reasons for | 

I non-compliance. "Guidelines" define approaches and techniques | 

' which are considered to be good practice, but should not be | 

I considered as requirements. The procedures for modifying or | 
i evolving this standard are contained within the contents of 1 
j this document. | 

-t- -I- 
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D.l Introduction 

The specifications contained in this appendix comprise a registry 
of exceptions to the architectural structure, which are intended 
to serve as guidelines to hardware implementors. These features 
are not required for conformance, and they will not be tested as a 
part of the certification process. It is recommended, however, 
that when implemented they be implemented in their entirety, and 
as closely as possible to the descriptions provided herein. 

Software is warned against the use of any of these functions, 
since they are not required and are not likely to be implemented 
in all products . 
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D.2 Reset to Initial State 

RESET TO INITIAL STATE RIS 


Purpose: Reset the terminal to power-up condition. 


Format: ESC c 

1/11 6/3 


Description: When this control is received all state in the 

terminal is set to their default values. 

Notes : 

1. Conforming software will not use the RIS control, but 
should use the Soft Terminal Reset (DECSTR) in Level 2 
operation to put the terminal into a known state. 

2. The default values of a certain state in some 
implementations may be set and stored under local control 
by the terminal user_(e.g., Set-Up and non-volatile RAM 
or -a disk) as well as remotely. In such implementations 
RIS will set the storable state to the values selected by 
the terminal user. Therefore software cannot rely on the 
values of this state after an RIS is executed. The 
values given in the algorithm below apply only to those 
implementations in which the state can not be set and 
stored locally by the terminal user. The state defined 
by the architecture to which this indeterminate condition 
may apply is limited to the following: 

CONFORMANCE _ LEVEL : ( LEVEL _ 1 , LEVEL _ 2 ) ; 

COLUMN, MODE: (EIGHTY,ONE THIRTY TWO) ; 

SCROLLING. MODE: ( JUMP, SLOW); 

SCREEN _ MODE : ( NORMAL . SCREEN , REVERSE . SCREEN ) ; 

AUTO .WRAP MODE: ( WRAP . OFF , WRAP . ON ) ; 

TEXT. CURSOR. ENABLE .MODE: ( TEXT . CURSOR . OFF , TEXT . CURSOR. ON ) ; 
INSERT. REPLACEMENT 'mode: (REPLACE,INSERT); 

NEW. LINE. MODE: ( NEW. LINE . OFF , NEW. LINE . ON ) ; 

HORIZONTAL. TAB. STOPS: ARRAY [ MAX . NUM , COLUMNS ] OF BOOLEAN; 
AUTO. REPEAT. MODE: (REPEAT.ON,REPEAt6fF); 

CURSOR. KEY. MODE: { CURSOR , CK APPLICATION ) ; 

KEYPAD. MODE: ( NUMERIC , KP APPLICATION ) ; 

CAPS. SHIFT. LOCK. MODE: ( CAPS . LOCK, SHIFT. LOCK ) ; 

AUTO. PRINT. MODE: ( AUTO _ PRINT _ OFF , AUTO . PRINT . ON ) ; 

PRINT. FORM FEED. MODE; { PRINT . FF . OFF , PRINT . FF . ON ) ; 

PRINT. EXTENT. MODE: ( PRINT . DI SPLAY , PRINT . SCROLLING . REGION ) ; 
GRAPHICS . CURSOR . ENABLE . MODE : 

( GRAPHICS . CURSOR . OFF ^ GRAPHICS . CURSOR . ON ) ; 
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3. The DRCS and UDK definitions are also cleared in Level 2 
operation. 


State Affected; 

CONFORMANCE _ LEVEL : ( LEVEL . 1 , LEVEL _ 2 ) ; 

IN _ USE ^ TABLE ; IN _ USE _ TABLE . TYPE ; 

DESIGNATED. GRAPHIC. SETS: 

ARRAY [g6..G3] OF GRAPHIC . CHARACTER . SET . TYPE ; 

IN. CONTROL. STRING: BOOLEAN; 

Cl .TRANSMISSION. MODE: ( SEVEN . BIT , EIGHT . BIT ) ; 

SINGLE. SHIFT; ( NONE , SS2 , SS3 ) ; 

TOP. MARGIN: LINE. TYPE; 

BOTTOM. MARGIN: LINE. TYPE; 

CURRENT . RENDITION ; CHARACTER . RENDITION . TYPE ; 

LINE RENDITION: ARRAY [LINE. TYPE] OF LINE. RENDITION. TYPE; 
COLUMN . MODE : (EIGHTY, ONE . TH I RTY . TWO ) ; 

SCROLLING. MODE; ( JUMP, SLOW) ; 

SCREEN. MODE: ( NORMAL . SCREEN , REVERSE . SCREEN ) ; 

ORIGIn’mODE: (ABS0LUTE,DISPLACED) ; 

AUTO . WRAP . MODE : ( WRAP . OFF , WRAP . ON ) ; 

TEXT ' CURSOR . ENABLE . MODE ; 

( TEXT . CURSOR . OFF , TEXT . CURSOR . ON ) ; 

INSERT . REPLACEMENT . MODE : ( REPLACE , INSERT ) ; 

NEW. LINE. MODE: ( NEW. LINE . OFF , NEW. LINE . ON ) ; 

DISPLAY: 'array [ LINE . TYPE , COLUMN . TYPE ] OF CHARACTER . TYPE ; 
ACTIVE POSITION : CHA^CTER POSITION TYPE ; 

CURSOR ' SAVE BUFFER : SAVE . BUFFER . TYPE ; 

HORIZONTAL .TAB. STOPS: ARRAY [ COLUMN . TYPE ] OF BOOLEAN; 
LAST. COLUMN. FLAG: BOOLEAN; 

KEYBOARD ACTION. MODE: ( UNLOCKED , LOCKED ) ; 

AUTO. REPEAT MODE: ( REPEAT . ON , REPEAT . OFF ) ; 

CURSOR. KEY MODE: ( CURSOR , CK APPLICATION ) ; 

KEYPAD. MODE: (NUMERIC, KP APPLICATION) ; 

CAPS SHIFT. LOCK MODE : ( CAPS . LOCK , SHI FT . LOCK ) ; 

COMPOSE . MODE : ( COMPOSE OFF , COMPOSE .ON); 

AUTO. PRINT. MODE: ( AUTO . PRINT OFF , AUTO . PRINT . ON ) ; 

PRINT . FORM. FEED . MODE : ( PRINT . FF . OFF , PRINT . FF . ON ) ; 

PRINT . EXTENT . MODE : 

( PRINT . SCROLLING . REGION , PRINT DISPLAY ) ; 

Graphics. CURSOR. ENABLE MODE: 

(GRAPHICS. CURSOR. OFF, GRAPHICS. CURSOR. ON) ; 

REGIS. GRAPH ICS. MODE: ( REGI S OFF , REGI S . ON ) ; 

SIXEL GRAPHICS MODE: ( SIXEL OFF , SIXEL ON) ; 
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Algorithm: 

PROCEDURE RESET, TO. INITIAL, STATE; 

VAR Y: LINE. TYPE; 

X: COLUMN. TYPE; 

BEGIN 

CASE SERVICE. CLASS OF (* see Note 1 *) 

61: CONFORMANCE. LEVEL:* LEVEL. 1; 

62: CONFORMANCE. LEVEL:* LEVEL.2; 

END; 

IN. USE. TABLE. CO:* ASCII.C; 

IN 'use. TABLE. GL:* ASCII.G; 

IN. USE. TABLE. INVOKED. GL:= GO; 

IN ^ USE .TABLE .Cl :* SUPPLEMENTAL.C; 

IN.USE.TABLE.INVOKED.gr:* G2 ; 

CASE CONFORMANCE. LEVEL OF 
LEVEL. 1 : 

BEGIN 

IN. USE. TABLE. GR:= ASCII.G; 

Cl .TRANSMISSION. MODE:* SEVEN. BIT; 

END; 

LEVEL.2: 

BEGIN 

IN. USE. TABLE. GR:* SUPPLEMENTAL.G; 

Cl. TRANSMISSION. MODE:* EIGHT.BIT; 

END ; 

END ; 

SINGLE. SHIFT:* NONE; 

IN. CONTROL. STRING:* FALSE; 

TOP. MARGIN:* 1; 

BOTTOM. MARGIN:* MAX.NUM.LINES; 

DESIGNATED. GRAPHIC. SETS [GO ] := ASCII.G; 

DESIGNATED.GRAPHIciSETS[Gl ] :* ASCII.G; 

CASE CONFORMANCE. LEVEL OF 
LEVEL . 1 : 

BEGIN 

DESIGNATED. GRAPHIC. SETS [G2 ] := ASCII.G; 

DESIGNATED. GRAPHIC. SETS[G3 ] :* ASCII.G; 

END; 

LEVEL.2: 

BEGIN 

DESIGNATED. GRAPHIC. SETS [G2] :* SUPPLEMENTAL.G; 
DESIGNATEd’gRAPHIC’ SETS[G3 ] :* SUPPLEMENTAL.G; 

END ; 

END; 

CURRENT RENDITION[ BOLD] := FALSE; 

CURRENT RENDITION [UNDERSCORE] := FALSE; 

CURRENT RENDITION] BLINK] := FALSE; 

CURRENT RENDITION] REVERSE] := FALSE; 

COLUMN. MODE:* EIGHTY; (* see Note 1 *) 

SCROLLING MODE:* SLOW; (* see Note 1 *) 

SCREEN MODE:* NORMAL SCREEN; (* see Note-1 *) 

ORIGIN 'mode:* ABSOLUTE; 
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AUTO.WRAP.MODE:= WRAP. OFF; 

( 

★ 

see 

Note 

1 

*) 

TEXT . CURSOR . ENABLE . MODE : = TEXT . CURSOR . ON ; 

( 

"k 

see 

Note 

1 

*) 

INSERT. REPLACEMENT. MODE := REPLACE; 

( 

* 

see 

Note 

1 

*) 

NEW. LINE. MODE:= NEW. LINE . OFF ; 

( 

k 

see 

Note 

1 

*) 


FOR y;= 1 TO MAX. NUM, LINES DO 
BEGIN 

FOR X:= 1 TO MAX . NUM . COLUMNS DO 

DISPLAY [ Y , X ] . CODE : = EMPTY . CHARACTER ; 

LINE.RENDITION[Y] ;= SINGLE.WIDTH; 

END ; 

ACTIVE. POSITION. LINE:= 1; 

ACTIVE. POSITION. COLUMN := 1; 

HORIZONTAL.TAB. STOPS[ 1 ] := FALSE; (* see Note 1 *) 

FOR X:= 2 TO MAX. NUM. COLUMNS DO 

IF X MOD 8 = ITHEN HORI ZONTAL . TAB . STOPS [ X ]: = TRUE 
ELSE HORIZONTAL.TAB. STOPS [ X] := FALSE; (* see Note 1 *) 

LAST. COLUMN. FLAG: = FALSE; 

SAVE. CURSOR; 

KEYBOARD .ACTION . MODE : = UNLOCKED ; 


AUTO. REPEAT. MODE := REPEAT.ON; 

(* 

see 

Note 

1 

*) 

CURSOR. KEY. MODE := CURSOR; 

(* 

see 

Note 

1 

*) 

KEYPAD. MODE := NUMERIC; 

(* 

see 

Note 

1 

*) 

CAPS .SHIFT. LOCK . MODE : = CAPS . LOCK ; 
C-OMp6sE.MODE:= COMPOSE . OFF ; ' 

(* 

see 

Note 

1 

*) 

AUTO . PRINT . MODE : = AUTO [ PRINT . OFF ; 

(* 

see 

Note 

1 

*) 

PRINT . FORM.. FEED . MODE : = PRINT . FF . OFF ; 

(* 

see 

Note 

1 

*) 

PRINT. EXTENT. MODE := PRINT DISPLAY; 

(* 

see 

Note 

1 

*) 


GRAPHICS. CURSOR. ENABLE MODE: = GRAPHICS . CURSOR _ ON ; (* see Note 1 *) 

REGIS. GRAPHICS. MODE := REGIS.OFF; 

SIXEL*GRAPHICS’mODE:= SIXEl'oFF; 

DEVICE. STATUS := READY; 

END ; 


Known Deviations: 

Execution of the RIS control on some older terminals may cause the 
terminal self-test to be performed, which takes several seconds 
and flashes test patterns on the display. It may also cause a 
modem disconnect to occur. Therefore, conforming software is 
recommended not to use this control. 
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D.3 Answerback 
D.3.1 Description 

The Answerback feature provides the terminal with the capability 
of transmitting a stored message (string of control and graphic 
codes) to the host port, either on a prompt received from the host 
port, or by request from the keyboard. Answerback is intended to 
provide a communications function, and should never be used as a 
"programmable function key". 

Devices which implement the Answerback capability should provide a 
user definable message of not less than 20 characters for Level 1 
devices and not less than 30 characters for Level 2 devices. The 
Answerback message buffer should contain any combination of 
control and graphic character codes (7-bit codes only for Level 1 
devices, and 8-bit codes for Level 2 devices). The Answerback 
message will be transmitted by the terminal on receipt from the 
host of an ENQ (0/5) control code, typing of the Here Is key at 
the terminal keyboard, or 500ms after a full-duplex modem 
connection is established with auto-answerback enabled. 

(Note: ' When a Here Is key is not provided on the keyboard, the 
Control Key in combination with the Break Key should be used as a 
fallback to provide this function.) 

The ability to erase the Answerback message buffer or enter new 
characters into the buffer is a Setup function. The buffer is 
empty by factory default. The buffer is a FIFO, and any unfilled 
positions remain empty. Characters are transmitted from the 
buffer exactly as if they were typed at the keyboard, and are 
subject to the same timing and rate limiting restrictions. 


MAX POSITION =20 ( * or more for Level 1 *); 

30 ( * or more for Level 2 *); 

ANSWERBACK _ MESSAGE _ BUFFER : 

ARRAY [ 1 . .MAX POSITION] OF CODE_TYPE; 

ANSWERBACK, MESSAGE SIZE: 1 .. MAX POSITION ; 
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D.3.2 Control Function 

ANSWERBACK ENQ 


Purpose: Cause the terminal to transmit a stored string of coded 

characters. 


Format: ENQ 

0/5 


Description: Receipt of the ENQ control code causes the 

te-rminal to transmit the coded character string stored in the 
Answerback message buffer. Characters are transmitted up to the 
first empty character position in the buffer. 

1. The number and value of character codes in the buffer is 
a Setup function, determined by the User. 


State Affected: None 


Algorithm: 

PROCEDURE ANSWERBACK; 

VAR N: 1. .MAX POSITION ; 

BEGIN 

FOR N:= 1 TO ANSWERBACK MESSAGE SIZE DO 
.'WRITE (HOST PORT, ANSWERBACK MESSAGE- BUFFER[ N ]) ; 
END ; 
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D.4 Device Test and Status 

TEST DECTST 


Purpose: Invoke the device self-tests. 


Format: CSI Ps y default Ps: 0 

9/11 PS 7/9 


Description: The DECTST control is provided as a means of 

invoking device specific diagnostic tests, and subsequently 
determining the device status by means of the Device Status Report 
(DSR) control. The sequence consists of a parameter string 
indicating a series of product specific tests to be performed. 

The architecture does not specify the nature or duration of any of 
the tests performed. The minimal implementation of this control 
is to to execute the Reset to Initial State (RIS) control, and to 
return a "Device Ready" indicator by default. 

Notes : 

1. Since the minimal implementation does not require the 
execution of any tests, and since the nature of the tests 
performed is not defined, software should not depend on 
the effects of using this control. In all probability 
execution of this control in any product will have an 
adverse effect on the state of the device, and after 
execution of this control the state of the device should 
be considered to be UNDEFINED. NO RECOVERY IS GUARANTEED 
WHEN THIS CONTROL IS EXECUTED. 

2. Product literature should be consulted for a description 
of any test sequences which might be performed on a 
specific product. 

State Affected: UNDEE’INED 


Algorithm: 

PROCEDURE TEST; 

BEGIN 

RESET TO_ INITIAL STATE; 

( * 

Execute product specific tests as indicated 
by the parameter value. 

*) 

END ; 
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D.5 Send/Receive Mode 

SET/RESET SEND/RECEIVE MODE ■ ■ SRM 


Purpose: Cause all data transmitted at the terminal interface to 

be echoed back into the terminal. 


Set Format: 


CSI 12 h 

9/11 3/1 3/2 6/8 


Reset Format: CSI 12 1 

9/11 3/1 3/2 6/12 


Description: The SRM control is used to affect the state of 

Send/Receive Mode in the terminal. Send/Receive Mode provides a 
means of looping all control and graphic data transmitted on the 
host port back into the re-eeiver. All data received by the 
terminal when this mode is set (Echo_On) will be interpreted as if 
transmitted directly from the host. The transmitted data will not 
be affected by the setting of this mode. 

SEND. RECEIVE, MODE, TYPE = (ECHO,OFF,ECHO,ON); 

SEND, RECEIVE, MODE: SEND, RECEIVE , MODE .TYPE; 


Algorithm: 

PROCEDURE SET _ SEND RECEIVE , MODE; 
BEGIN 

SEND, RECEIVE, MODE := ECHO. ON; 

END; , 


PROCEDURE RESET. SEND. RECEIVE, MODE; 
BEGIN 

SEND. RECEIVE MODE:= ECHO OFF; 

END ; 
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D.6 Auto Wrap Mode 
D.6.1 Description 


Auto Wrap Mode provides the ability to select wrapping of 
lines when the right line boundary is reached while entering 
characters into the display [set state = wrapon]. This state 
applies 

only to entering data, and does not affect movement of the cursor 
using any of the cursor positioning functions or control codes. 
When 

auto -wrapping is not enabled [reset state = wrap off], attempts to 
enter characters beyond the right line boundary are handled by 
overwriting the character at the last column in the line. 

AUTO, WRAP _ MODE: ( WRAP , OFF , WRAP _ ON ) ; 


A special condition occurs when writing a Space or graphic 
character into the last column position of a line while Auto Wrap 
Mode is set. Normally the Active Position is advanced immediately 
after a character is entered into the display. The only exception 
to this is when a character is entered into the last column, 
position of a line, in which case the Active Position cannot be 
advanced. When Auto Wrap Mode is set, however, writing a character 
into the last position in a line causes a special flag (referred 
to as the Last Column Flag) to be set. This flag is checked each 
time a character is entered into the display, and if Auto Wrap 
Mode is set, will cause the Active Position to advance to the 
first column of the next line PRIOR to entering that character. 

The flag is then reset. 

The Last Column Flag should also be reset by executing any control 
which potentially changes the Active Position from the end-of-line 
position. These controls include the following: 


SET _ TOP _ AND BOTTOM _ MARGINS 

SINGLE_WIDTH_LINE 

DOUBLE WIDTH 'line 

DOUBLE _ HEIGHT . LINE _ TOP 

DOUBLE _ HEIGHT _ LINE _ BOTTOM 

SET MODE ( COLUMN, MODE, ORIGIN, MODE) 

RESET, MODE ( COLUMN MODE , ORIGIN MODE, AUTO, WRAP MODE) 

INSERT OR REPLACE CHARACTER 

CURSOR UP 

CURSOR, DOWN 

CURSOR FORWARD 

CURSOR BACK 

CURSOR, POSITION 

HORIZONTAL, VERTICAL POSITION 

BACK, SPACE 
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HORIZONTAL, TAB 
LINE, FEED 
VERTICAL, TAB 
FORM, FEED 
CARRIAGE , RETURN 
SUBSTITUTE 
INDEX 

REVERSE, INDEX 

NEXT, LINE 

ERASE, CHARACTER 

DELETE _ CHARACTER 

INSERT, CHARACTER 

ERASE, IN, LINE 

SELECTIVE, ERASE, IN, LINE 

DELETE, LINE 

INSERT*LINE 

ERASE, IN, DISPLAY 

SELECTIVE, ERASE, IN, DISPLAY 

Furthermore, the state of the Last Column Flag should be saved 
when a Save Cursor operation is performed, and restored when a 
Restore Cursor operation is performed. 

It should be noted that existing products vary widely in their 
handling of the end-of-line condition in regards to resetting the 
Last Column Flag. 
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D.6.2 Control Function 

SET/RESET AUTO WRAP MODE DECAWM 


Purpose; Change the state of Auto Wrap Mode between Wrap Off 
(reset) and Wrap On (set). 


Set Format: 


CSI ? 7 h 

9/11 3/15 3/7 6/8 


Reset Format: 


CSI 

9/11 


3/15 


7 

3/7 


1 

6/12 


Description: The DECAWM controls are used to change the state 

of Auto Wrap Mode between Wrap Off (reset state) and Wrap On (set 
state). (For a complete description of Auto Wrap Mode, see the 
section "State Descriptions") 


State Affected: 

AUTO_WRAP_MODE: ( WRAP _ OFF , WRAP _ ON ) ; 


Algorithm: 

PROCEDURE SET AUTO _WRAP MODE ; 
BEGIN 

AUTO WRAP MODE: = WRAP ON; 

END ; 


PROCEDURE RESET _AUTO_ WRAP MODE ; 
BEGIN 

AUTO WRAP MODE: = WRAP OFF; 

END ; ' ’ 
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D.7 Control Representation Mode 


A device may provide a mode of operation in which all received 
control and graphic codes are displayed visually, and their normal 
execution is ignored or redefined. This mode is provided for test 
purposes and is not to be used by conforming software. 

Although Control Representation Mode is defined in the ANSI 
standard X3.64 for use with the Set Mode and Reset Mode control 
functions, it is recommended that within Digital it be 
implemented only as a locally selected function, and not be 
accessible from the host. 


CONTROL_REPRESENTATION_MODE: ( DI SPLAY _ OFF , DISPLAY , ON ) ; 


In the set state (Display On) all control functions (except the 
Reset Mode control sequence for Control Representation Mode) are 
displayed as graphic characters. Thus all character codes (128 in 
7-bits and 256 in 8-bits) will be displayed with unique 
representations. No control functions will be executed, with the 
following exceptions: 


• o LF - Display the graphic character for LF, and then 
execute a 
new line ( CR LF ) . 

o FF - Display the graphic character for FF, and then 
execute a 
new line ( CRLF ) . 

o VT - Display the graphic character for VT, and then 
execute a 
new line ( CRLF ) . 

o XOFF - Display the graphic character for XOFF, and 
suspend 

transmission from the terminal to the host (its normal 
function ) . 


o XON - Display the graphic character for XON, and resume 
transmission from the terminal to the host (its normal 
function) . 


o RM - Reset Mode, if it contains the parameter for CRM 
(which 

is 3), will cause CRM to be reset, and control characters 
will 

resume their normal actions. If RM does not contain the 
parameter 

for CRM, its characters are displayed as graphic 
characters . 
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In the reset state ( Display _Off ) the terminal resumes its normal 
operation . 
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Notes: 

1. When set, this control function causes NUL and DEL to be 
displayed, so these characters may not be used as fill 
characters 

when CRM is set. 

2. Control functions already received and processed by the 
terminal are not affected by setting Control 
Representation Mode, 

and will not be displayed. Control functions displayed 
while Control Representation Mode is set will not be 
processed 

again after the mode is reset. 

3. While Control Representation Mode is set G2 and GR will 
be 

designated and invoked to be the DEC Supplemental set, 
regardless 

of the existing state of designation or invocation. The 
Cl 

characters, and any GR (DEC Supplemental) characters that 
are not 

assigned (reserved for future standardi-z-ation ) , will be 

displayed 

as "hex pairs". 
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D.8 Screen Alignment 

SCREEN ALIGNMENT DECALN 


Purpose: Fill the entire display with a test pattern for 

alignment purposes. 

Format: ESC # 8 

1/11 2/3 3/8 

Description: The DECALN control is used to fill the physical 

display with a screen alignment pattern which is implementation 
defined. 

Notes: 

1. This control is provided strictly as a maintenance aid 

and is not intended for use by any applications software. 


State Affected: 

DISPLAY: ARRAY [LINE TYPE, COLUMN TYPE] OF CHARACTERTYPE; 
LINE_RENDITION: ARRAY [LINE_TYPE] OF LINE_RENDITION_TYPE; 
ACTIVE, POSITION: CHARACTER, POSITION, TYPE ; 

TOP, MARGIN: LINE _ TYPE; 

BOTTOM, MARGIN: LINE TYPE; 

CURRENT _ RENDITION : CHARACTER RENDI TION, TYPE ; 

CURRENT TABLE : = CHARACTER TABLE TYPE ; 

ORIGIN MODE: ORIGIN MODE TYPE; 

LAST, COLUMN FLAG: BOOLEAN; 


Algorithm: 

PROCEDURE SCREEN, ALIGNMENT; 

VAR Y: LINE [type; 

X: COLUMN, TYPE; 

BEGIN 

ORIGINMODE := ABSOLUTE; 

CURRENT, RENDITION [BOLD] := FALSE; 
CURRENT RENDITION[ UNDERSCORE] := FALSE; 
CURRENT, RENDITION[ BLINK] := FALSE; 
CURRENT RENDITION[ REVERSE] := FALSE; 

FOR Y:= 1 TO MAX NUM LINES DO 
BEGIN 

LINE RENDITION[Y] := SINGLE , WIDTH ; 

FOR X : = 1 TO MAX NUM COLUMNS DO 
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DI SPLAY [ Y,X] .CODE:= EMPTY _ CHARACTER ; 
END ; 

ACTIVE_POSITION.LINE:=. 1; 

ACTIVE, POSITION. c6lUMN:= 1 ; 

TOP. MARGIN := 1; 

BOTTOM. MARGIN := MAX.NUM.LINES; 

LAST. COLUMN. FLAG := FALSE; 

END; 
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D.9 Local Function Keys 


The use of Local Function Keys in terminals is described in the 
section "Keyboard Processing". Normally these keys never transmit 
characters at the coding interface. However, in certain 
implementations they may be used by internal software, such as in 
a Personal Computer or Workstation. In these cases, the following 
codes are assigned for their use. 

Control sequences designated for these keys are intended only 
for use as an internal interface, and should be ignored by 
conforming application software. 

The use of Shift and/or Control Keys affect the interpretation of 
the Local Function Keys. 


Note: In cases where the Compose function is not handled locally 
by the terminal, it may be necessary to treat the Compose Key as a 
Local Function Key so that the Compose function can be implemented 
at a higher level in the system. In this case, the Compose Key 
should transmit the code sequence CSI 10 ~ (9/11 3/1 3/0 7/14). 
This sequence is reserved for this use, and should not be 
re-assigned to any other key. Conforming software will ignore 
this code sequence. 


In the following table, the first entry indicates the code 
sequence transmitted when Cl Transmission Mode is in the reset 
(SEVEN BIT) state. The second entry indicates the code sequence 
transmitted when Cl Transmission Mode is in the set (EIGHT BIT) 
state . 

Since the Local Function Keys are not usually transmitted (but are 
usually interpreted locally by the terminal), the coding in the 
following table is independent of the conformance level of 
operation. 
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Codes Possibly Used by Local Function Keys 


Key 

Legend 

All : 

Levels 

G99 

Hold Screen 
( normal ) 

1/11 

5/11 

9/11 


Hold Screen 

1/11 

5/11 


(with Shift) 


9/11 


Hold Screen 
(with Control) 

1/11 

5/11 

9/11 

GOO 

Print Screen 
( normal ) 

1/11 

5/11 

9/11 


Print Screen 
(with Shift) 

1/11 

5/11 

9/11 


Print Screen 
(with Control) 

1/11 

5/11 

9/11 

GOl 

Set-Up 
( normal ) 

1/11 

5/11 

9/11 


Set-Up 
(with Shift) 

1/11 

5/11 

9/11 


Set-Up 

(with Control) 

1/11 

5/11 

9/11 

G02 

F4 (Data/Talk) 

( normal ) 

1/11 

5/11 

9/11 


F4 (Data/Talk) 
(with Shift) 

1/11 

5/11 

9/11 


F4 (Data/Talk) 
(with Control) 

1/11 

5/11 

9/11 

G03 

Break 
( normal ) 

1/11 

5/11 

9/11 


Break 

(with Shift) 

1/11 

5/11 

9/11 


Break 

(with Control) 

1/11 

5/11 

9/11 


3/1 

3/1 

7/14 


(ESC [ 

11 

~ ) 

3/1 

3/1 

7/14 


( CSI 

11 

~) 

3/15 

3/1 

3/1 

7/14 

(ESC [ 

7 

11 ~ ) 

3/15 

3/1 

3/1 

7/14 

( CSI 

p 

11 ~ ) 

3/14 

3/1 

3/1 

7/14 

(ESC [ 

> 

11 ~ ) 

3/14 

3/1 

3/1 

7/14 

( CSI 

> 

11 ~ ) 

3/1 

3/2 

7/14 


(ESC [ 

12 

~ ) 

3/1 

3/2 

7/14 


( CSI 

12 

~ ) 

3/15 

3/1 

3/2 

7/14 

(ESC [ 

p 

12 ~ ) 

3/15 

3/1 

3/2 

7/14 

( CSI 

p 

12 ~ ) 

3/14 

3/1 

3/2 

7/14 

(ESC [ 

> 

12 ~ ) 

3/14 

3/1 

3/2 

7/14 

( CSI 

> 

12 ~ ) 

3/1 

3/3 

7/14 


(ESC [ 

13 

- ) 

3/1 

3/3 

7/14 


( CSI 

13 

~ ) 

3/15 

3/1 

3/3 

7/14 

(ESC [ 

p 

13 ~ ) 

3/15 

3/1 

3/3 

7/14 

( CSI 

p 

13 ~ ) 

3/14 

3/1 

3/3 

7/14 

(ESC [ 

> 

13 ~ ) 

3/14 

3/1 

3/3 

7/14 

( CSI 

> 

13 ~ ) 

3/1 

3/4 

7/14 


( ESC [ 

14 

~ ) 

3/1 

3/4 

7/14 


( CSI 

14 

~ ) 

3/15 

3/1 

3/4 

7/14 

(ESC [ 

p 

14 ~ ) 

3/15 

3/1 

3/4 

7/14 

( CSI 

p 

14 ~) 

3/14 

3/1 

‘3/4 

7/14 

(ESC { 

> 

14 ~) 

3/14 

3/1 

3/4 

7/14 

( CSI 

> 

14 ~ ) 

3/1 

3/5 

7/14 


(ESC [ 

15 

~ ) 

3/1 

3/5 

7/14 


( CSI 

15 

~ ) 

3/15 

3/1 

3/5 

7/14 

(ESC [ 

p 

15 ~ ) 

3/15 

3/1 

3/5 

7/14 

( CSI 

p 

15 ~ ) 

3/14 

3/1 

3/5 

7/14 

( ESC [ 

> 

15 - ) 

3/14 

3/1 

3/5 

7/14 

( CSI 

> 

15 ~ ) 
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D.IO Change History 
D.10.1 Rev AXIO to AXll 


1. Renamed screen modes NORMAL. .SCREEN and REVERSE. .SCREEN 
in code 

for better consistency. 

2. Renamed character rendition from REVERSE VIDEO to 
REVERSE throughout 

code for better consistency. 

3. Removed paragraph describing auto-wrap as a user 
preference feature. 

Auto-wrap is no longer defined as a user preference 
feature. 

4. Modified algorithm for DECALN to include effect on 
ORIGIN. MODE 

and CURRENT RENDITION. 


5. Removed statement that DECALN resests terminal. 
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Section Index 


-A- 

Answerback D-9 

auto answerback D-9 

control function D-10 

message buffer D-9 

Auto Wrap Mode D-13 

control function D-15 

-C- 

C1 Transmission Mode D-20 

Compose Key 

as local function key D-20 

Conformance Level D-20 

Control Codes 

answerback D-10 

Control Key 

with local function key D-20 

Control Representation Mode — D-16 

-D- 

DECALN D-18 

DECAWM D-15 

DECTST D-ll 

Default 

undefined D-5 

Device Status D-ll 

Device Test D-ll 

-E- 

ENQ d-9, d-10 

-I- 

Initialization D-5 

-L- 


Last Column Flag 
definition 


D-13 
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MASTER INDEX 

- 


-A- 

Absolute Location 

definition 

8-12 


Active Position 

5-16 
A- 7 


definition 

5-9 

8-12 


Algorithms 

2-4 


Alphabets 

8-119 


Announce Subset of Code 

Extension Facilities 

3-68 


Answerback 

D-9 


auto answerback 

D-9 


control function 

D-10 


message buffer 

D-9 


APC 

introducer 

3-29 


Application 

definition 

5-9 


Application Free Primitives 

definition 

8-12 


Application Function Key Row 

within compose sequence 

6-141 


Application Function Keys 

6-15, 

6-28, 6-30, 6-32, 6-70 

Application Label Strip 

definition 

6-25 


Application Process 

6-12, 

6-14 

definition 

6-25 


Application Program 

definition 

5-9 


Application Program Command 

3-28 


Application Programs 

B-6 


Architecture 

conformance levels 

1-12 


deviations 

1-14 


exceptions 

1-13 


exclusions 

1-13 


extensions 

1-12 


hardware/firmware 

conformance 

1-15 


layers 

1-8 


model 

1-8 


requi red 

1-12 


service class 

4-8 


service classes 

1-10 
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Architecture (Cent.) 
software conformance 
undefined 
virtual terminal 
waivers 

Area Attributes 
ASCII Character Set 
ASCII Code 
ASCII Stream 
Audible Indicator 
definition 
Audible Indicators 
Auto Print Mode 
control function 
definition 
description 
Auto Repeat 

within compose sequence 
Auto Repeat Mode 
Auto Wrap Mode 
control function 


1-16 

1-14 

1-8 

1-13 

8-102 

8-29, 8-37, 8-81, 8-119, 8-121 
8-22, 8-29, 8-30, 8-112, 8-119 
1-9 


5-10 

5- 73 

6- 73 

7- 35 
7-5 
7-11 
B-16 
6-134 

6-16, 6-40, 6-172 

D-13 

D-15 


-B- 


Back Space 

control function 
Backspace 

VT52 control function 
Base Logical Device 
definition 
Base ReGIS 


Batching Commands 

BEL 

Bell 

definition 
Bit Combination 
definition 
parameter 

within control function 
Blink Rendition 
Bold Rendition 
Bottom Margin 
default value 
Bracketed Pair 
definition 
Break 

definition 
Long Break 


5-74 

A-29 

8-34, 8-35 
8-12 

8-23, 8-34, 8-37, 8-47, 8-58, 
8-64, 8-69, 8-74, 8-87, 8-98, 
8-103, 8-112 
8-42, 8-128 
5-73 

5-10 

3-12, 3-61 

3-10 

3-24 

3-16 

5-23 

5-23 

5-32 

5-32 

8-12 

12-14 

12-14 

12-14 
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Break ( Cont . ) 

when it may be transmitted 
Break Key 

Breakthrough 

BS 

Buffer 

overflow prevention 
requi rements 
size 
Byte 

definition 

-C- 

C language 
C(A) 

C(B) 

C(C) 

C(E) 

C(S) 

C(W) 

CO Control Characters 

7- bit encoding 

8- bit encoding 
CO Control Code 

within control function 
Cl Control Characters 
in user defined keys 
within control functions 
within control strings 

7- bit encoding 

8- bit encoding 
Cl Control Code 

within control function 
Cl Transmission Mode 


Cancel 
Caps Lock 

Caps/Shift Lock Mode 

Carriage Return 
control function 
VT52 control function 
Cartesian Coordinate Grid 
Cell Matrix Size 
definition 
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12-15 

6-74 

12-15 


12-13 

5- 74 

12-8 

12-5 

12-8 

6- 25 



3-31 

8-76, 

8-77, 

8-90 

8-77, 

8-90 


8-76, 

8-77, 

8-90 

8-77, 

8-90 


8-77, 

8-90 


8-78, 

8-80 


3-60, 

3-12 

3-65 


3-14 



3-22, 

3-23 


3-60, 

11-5 

3-19 

3-30 

3-65 


3-23, 

3-71 


3-14, 

3-72 


3-22, 

3-24 


3-67, 

3-71, 

3-72 


6-61, 6-64, 6-66, 6-69, 6-70, 
6-172 

D-20 

3-19, 3-30 

6-16, 6-17, 6-77, 6-78, 6-82, 
6-172 

6-16, 6-17, 6-77, 6-78, 6-82, 
6-172 

5-80 

A-32 

8-33, 8-59 
10-5 
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Certification 

waiver panel 

1-28 


Certification Testing 

1-27 


Chain Encoding 

8-52, 

8-67 

Character 

defined 

3-10 


definition 

6-25 


rendition 

5-22 


Character Attribute 

5-24 


definition 

5-10 


normal 

5-24 


selection 

5-41 


selectively erasable 

5-24 


Character Cell 

5-16 



8-24, 

8-82, 8-114, 8-120 

definition 

10-5 


Character Cell Display 

definition 

5-6 


Character Cell Matrix Size 

10-17 


height 

10-13 


width 

10-11 


Character Code 

3-12 


control 

3-16 


definition 

3-10 


graphic 

3-16 


Character Codes 



ReGIS 

8-29 


Character Font Data 

10-16 


Character Fonts 

8-38, 

8-100 

Character Imaging Device 

definition 

5-10 


Character Pattern 

10-17 


Character Position 

5-16 


definition 

5-10 


Character Rendition 

definition 

5-10 


Character Set 

3-59 


definition ' 

3-10 

10-5 


designation 

3-62 

5-34 


repertory 

3-60 


7-bit 

3-12 


8-bit 

3-14 


Character Set Extension 

A- 9 


Character Set Mode 

6-22, 

6-172 

Character Set Size 

10-10 

, 10-14 

Character Sets 

5-21 


Circle Constructs 

8-24, 

8-74, 8-76 

Circle Instruction 

8-20 
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Clear Communications 
Closed Curve Sequence 
definition 
Code Extension 

control code 
control sequence 
definition 
escape sequence 
graphic code 
Code Table 

definition 
row and column 
structure 
Coded Character 
definition 
Coding 

algorithms 
Coding Interface 
definition 
Color 
HLS 

Color by Index 
Color by Value 
Color Capability 
Color Introducer 
Color Map 
Column 
Column Mode 

control function 
Command Keyletter 
definition 
Command String 
Compatibility 
Complement Writing 
definition 
Compose 
Compose Key 

as local function key 
Compose LED 
Compose Mode 
Compose Sequence 
algorithm 
auto repeat 
buffering 
cancelling 
case within 
definition 
errors 


12-11 

8-12 

1- 9 
3-16 

3-18 

3-23 

3-10 

3-22 

3-59 

3-62 

11-5 

3-10 

3-11 

3-13, 3-15 
6-25 

2- 4 

6-12, 6-14 
6-25 

8-13 

8-97 

8-97 

8- 23, 8-35, 8-69, 8-95, 8-128 

9- 18 
B-39 
5-16 
5-18 
5-47 

8-12 

3- 29 
1-26 


8-12 

6-12, 6-44 
6-12, 6-44 
D-20 

6-30, 6-44, 
6-172 

6-44, 6-81 

6-145 

6-134 

6-37 

6-138 

6-140 

6-25 

6-141 


6-141 
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Compose Sequence (Cont.) 
explicit 

implied 

order within 

restarting 

syntax 

Compose Sequences 
Compressed Sixel Printing 
Conformance 
deviations 
exceptions 
exclusions 
extensions 
hardware/firmware 
keyboard 
Level 1 
Level 2 

locking shifts 
product 

required functions 
single shifts 
software 

user defined keys 
waiver process 
waivers 

Conformance Levels 


definition 

Conformance Requirements 
Conforming Software 

font number specification 
Control Character 
CO 
Cl 

Cl expansion 
cancel 

code extension techniques 
definition 

escape 

substitute 

unimplemented 

within control function 

7- bit environment 

8- bit environment 


6-20, 6-26, 6-42 
6-134, 6-140, 
6-26, 6-42, 6-79 
6-140, 6-145 
6-140 
6-138 
6-143 

6- 12, 6-19, 6-20 

7- 60 

1-14 

1-13 

1-13 

1-12 

1-15 

6-15 

1-17 

1-23 

3-61 

1-26 

1-12 

3-62 

I- 12, 1-14, 1-16 

3- 62 

II- 4 
1-28 
1-13 

6-17, 6-38, 6-70 
B-11 
D-20 
1-12 

4- 7 
1-12 

10-10 

3-16 

3-14 

3-14, 3-19 
3-23 
3-19 
3-18 
3-10 
6-25 
3-19 
3-19 
3-20 

3-22, 3-23 

3-16 

3-16 
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, 6-79, 6-80, 
6-145 

, 6-80, 6-134, 


, 6-54 


, 6-172 
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Control Code 
back space 
carriage return 
execution 
form feed 
horizontal tab 
horizontal tabulation set 
index 
line feed 
next line 
reverse index 
substitute 
vertical tab 
Control Codes 
answerback 
warning bell 
Control Function 
categories 
definition 

precedence 
Control Key 
auto repeat 

with local function key 
with new line mode 
with shift key 
within compose sequence 
Control Representation Mode 
Control Sequence 
definition 
execution 
format 
introducer 
numeric parameter 
parameter 
parameter string 
parsing 

private parameter 
selective parameter 
termination 
unimplemented 

use by application programs 
Control Sets 
Control String 
definition 

string terminator 

termination 

types 

unimplemented 


5-74 

5-80 

2- 15 
5-79 
5-75 
5-85 
5-82 
5-76 
5-84 
5-83 
5-81 
5-78 

D-10 

5- 73 

3- 16 
3-18 
3-10 

6-25 

3-18 

6- 61, 6-63, 6-69 
6-42 

D-20 

6-79 

6-77 

6-141 

D-16 

3-18, 3-23 
3-10 
2-18 
3-23 
3-23 

3-11, 3-25 
3-24 

3-11, 3-24 

3-31 

3-26 

3-11, 3-25 
3-18, 3-19 
3-20 

B-6, B-9 
3-65 
3-18 
3-10 
10-5 
3-28 

3-19, 3-30 

3-28 

3-20 
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, 6-70, 6-75 
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CPR 

CR 

Cross Reference 


CTRL/Q 

from the keyboard 
CTRL/S 

from the keyboard 
CTRL/Y 
CUB 
CUD 
CUF 
CUP 

Current Location 
definition 
Cursor 

definition 
Cursor Backward 
control function 
Cursor Control 
definition 
Cursor Down 

control function 
VT52 control function 
Cursor Forward 
control function 
Cursor Home 

VT52 control function 
Cursor Key 

within compose sequence 
Cursor Key Mode 
Cursor Keypad 
Cursor Left 

VT52 control function 
Cursor Movement 
cursor backward 
cursor down 
cursor forward 
cursor position 
cursor position report 
cursor up 

horizontal/vertical 
position 
Cursor Position 
control function 
Cursor Position Report 
control function 
Cursor Restore 


5-68 

5-80 

8-29, 8-34, 8-37, 8-38, 8-39, 
8-42, 8-43, 8-46, 8-52, 8-57, 
8-59, 8-64, 8-72, 8-82, 8-94, 
8-103, 8-106, 8-109, 8-138 

12-13 

12-13 

12-11 

5-63 

5-60 

5-62 

5-64 

8-12 

5-17 

5-11 

5-63 

5-11 

5-60 

A-24 

5- 62 
A-27 

6- 28, 6-60, 6-61, 6-62 
6-141 

6-16, 6-60, 6-172 
6-33 

A-26 


5-63 

5-60 

5-62 

5-64 

5-68 

5-58 

5-66 

5-64 

5-68 

5-69, 5-71 



EL-00070-IN 

14-Apr-1989 

Page 

Index- 11 

VSRM - Master Index 

Digital 

Internal 

Use Only 


Cursor Right 

VT52 control function 

A-25 

Cursor Save 

5-69, 5-71 

Cursor Save Buffer 

5-25 

Cursor Symbol 

5-20 

definition 

5-11 

Cursor Up 

control function 

5-58 

VT52 control function 

A-23 

Curve Instruction 

8-20, 8-48, 8-74, 8-75, 8-80 

CUU 

5-58 

-D- 

DA 

2-21 

DAI 

4-22, 4-29, 4-31 

B-13 

DA2 

B-14 

Data Set Ready 

7-7 

Data Terminal Ready 

7-7 

DCH 

5-88 

DCS Introducer Sequence 
definition 

10-5 

Dead Key 

within compose sequence 

6-141 

DEC STD 070-1 

3-62, 3-76, 3-77, 3-88 

DEC STD 070-12 

6-23, 6-72, 6-74, 6-76 

DEC STD 070-3 

6-23, 6-74 

DEC STD 070-4 

6-23, 6-74 

DEC STD 070-5 

3-65, 3-88 

DEC STD 070-6 

3-7, 3-17, 3-63, 3-64, 3-88 

DEC STD 070-7 

3-66, 3-88 

DEC STD 107-0 

6-23, 6-73 

6-12, 6-13, 6-15, 6-23, 6-26, 

DEC STD 107-2 

6-75 

6-30 

DEC STD 138-0 

3-25, 3-88 

DEC STD 169 

6-23 

4-50 

DEC STD 169-0 

B-8 

3-62, 3-68, 3-83, 3-88 

DEC Supplemental Graphics 

6-15, 6-23, 6-82, 6-186 

8-11 

B-8 

DECALN 

D-18 

DECARM 

6-41 

DECAWM 

B-16 

D-15 

DECCKM 

6-62 

DECCOLM 

5-47 
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DECDHLB 

5-45 


DECDHLT 

5-45 


DECDLD 

10-8 


DECDWL 

5-44 


DECID 

4-33 


DECKBUM 

B-14 

6-57 


DECKPAM 

6-66 


DECKPNM 

6-67 


DECmate/WPS 

Main Key Array 

6-130 


DECNKM 

6-68 


DECNRCM 

3-7, 3 

-64 

DECOM 

6-52 

5-51 


DECPEX 

7-38 


DECPFF 

7-37 


DECRC 

5-71 


DECSC 

5-69 


DECSCA 

5-41 


DECSCL 

4-27 



B-11, B 

-14 

DECSCLM 

5-49 


DECSCNM 

5-50 


DECSED 

5-100 


DECSEL 

5-94 


DECSR 

4-35 


DECSTBM 

5-32 


DECSTR 

4-37 


DECSWL 

5-43 


DECTCEM 

5-54 


DECTST 

B-15 

B-15 


Implied XOFF Rule 

D-11 

12-14 


Default 

definition 

5-11 


factory 

4-7 


modes 

5-20 


scrolling region 

5-32 


top and bottom margins 

5-32 


undefined 

4-17 


Default Designation and 
Invocation 

D-5 

3-6 3, 

3-68, 3-69 

Default Key Definitions 

11-5 


Defaults 

character set designation 

3-63, 

3-68 

character set invocation 

3-63, 

3-68 
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Delete 

3-12, 

3-14, 3-17 

character 

5-88 


definition 

5-11 


line 

5-96 


Delete Character 

control function 

5-88 


Delete Key 

6-80 


with shift key 

6-77 


Delete Line 

control function 

5-96 


Designate 

3-60, 

3-62 

character set 

5-34 


defaults 

3-63, 

3-68 

definition 

3-10 

5-11 

10-5 


Designated Graphic Sets 

3-60 


definition 

3-65 


Deviations 

definition 

1-14 


Device Attributes 

8-69 


control function 

2-21 



4-22, 

4-29, 4-31 

primary 

4-7, 

B-13 

4-22 

secondary 

4-7, 

B-14 

4-29 

tertiary 

4-7, 

4-31 

Device Control 

4-27 


Device Control String 

3-28 

B-11 


execution 

2-20 


format 

3-28 


introducer 

3-28 


numeric parameter 

3-11 


parameter string 

3-11 


parsing 

3-31 


selective parameter 

3-11 


Device Identification 

4-8, 

B-13 

4-22, 4-29, 4-31, 4-33 

Device Status 

4-16, 

D-11 

4-41 

Device Status Report 

control function 

2-22 

4-41 

7-32 


user defined keys 

11-7 


Device Test 

4-16 
. B-15 

D-11 
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Diacritical Mark 
definition 

6-25 


Dimensional Displays 

8-95 


Direct Cursor Address 

VT52 control function 

A-28 


Disconnect 

Long Break 

12-14 


Display 

5-16 


definition 

5-11 


Display Attributes 

select character attribute 

5-41 


select graphic rendition 

5-39 


Display Cell 

8-116 


Display Logic 

5-16 


Display Surface 

8-33, 

8-59, 8-81 

definition 

8-12 


DL 

5-96 


Dot 

terminology 

9-6 


Double Height Line 

5-25 


control function 

5-45 


Double Width Line 

5-25 


control function 

5-44 


Down Line Load (Font) 
control function 

10-8 


dpANS X3. 134. 1-1985 

3-89 


Drawing Instructions 

4-50 

8-55 


Drawing Position 

8-52, 

8-75, 8-77, 8-81, 8-88 

Drawing Primitives 

8-22, 

8-74 

Drawing Process 

8-32, 

8-36 

DRCS 

5-21 



10-4, 

10-6 

DSR 

2-22 


Dynamic Attributes 

4-41 

7-32 

11-7 

8-102 


Dynamically Redefinable 
Character Sets 

10-4, 

10-6 

-E- 

EBCDIC Code 

8-37 


ECH 

5-87 


Echo 

definition 

8-12 


ED 

5-98 


Editing Keypad Front Legends 

6-32 
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Editing Keypad Key 

6-15, 6-19, 6-28, 6-32, 6-69, 
6-70 

within compose sequence 

6-141 

Editor Function 

definition 

5-12 

Eight Bit Encoding 

8-43, 8-70, 8-121, 8-143 

EL 

5-92 

Emergency Messages 

12-13 

Empty Character 

5-27 

definition 

5-12 

End Of Line 

internal function 

5-30 

Engineering Change Orders 

(ECOs) 

8-57 

ENQ 

D-9, D-10 

Enter 

definition 

5-12 

Enter Alternate Keypad Mode 

VT52 control function 

A-16 

Enter Auto Print Mode 

VT52 control function 

A-37 

Enter Graphics Mode 

VT52 control function 

A-20 

Enter Printer Controller Mode 

VT52 control function 

A-39 

Enter VT52 Emulation Mode ■ 

VT52 control function 

A-14 

Environment 

definition 

3-10 

6-25 

host port 

3-66 

printer port 

3-66 

transformation 

3-21 

7-bit and 8-bit 

3-12, 3-21, 3-59, 3-66 

Erase 

character 

5-87 

definition 

5-12 

in display 

5-98 

in line 

5-92 

(selective) in display 

5-100 

(selective) in line 

5-94 

Erase Character 

control function 

5-87 

Erase Control 

10-11 

Erase In Display 

control function 

5-98 

Erase In Line 

control function 

5-92 

Erase to End of Line 

VT52 control function 

A-34 
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Erase to End of Screen 




VT52 control function 

A-35 



Erase Writing 




definition 

8-12 



Error Conditions 




user defined keys 

11-15 



Errors 

8-46, 

8-50, 8-51, 8-63, 

8-68, 


8- 

74, 8-88, 8-113 


reporting 

8-135 



Escape 

3-19, 

3-22, 3-30 


Escape Key 




auto repeat 

6-42 



Escape Sequence 

3-18, 

3-22 


definition 

3-10 




10-5 



execution 

2-16 



expansion escape sequence 

3-11, 

3-23 


format 

3-22 



parsing 

3-31 



termination 

3-18, 

3-19 


unimplemented 

3-20 



use by application programs 

B-6 



Event Handling Tables 




control codes 

2-15 



control sequences 

2-18 



device control string 

2-20 



escape sequences 

2-16 



Exceptions 




definition 

1-13 



Exclusions 




definition 

1-13 



Executive Loop 

2-13 



Exit Alternate Keypad Mode 




VT52 control function 

A-19 



Exit Auto Print Mode 




VT52 control function 

A-38 



Exit Graphics Mode 




VT52 control function 

A- 2 2 



Exit Printer Controller Mode 




VT52 control function 

A-40 



Exit VT52 Emulation Mode 




VT52 control function 

A-15 



Expanded Print 




sixel 

7-59, 

7-61 


Expansion Escape Sequence 

3-23 



definition 

3-11 



Explicit Compose Sequence 

6-20, 

6-42, 6-79, 6-80, 

6-134, 


6- 

140 


algorithm 

6-145 



definition 

6-26 
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Extended Logical Graphics 

Device 

in 

ro 

1 

GO 

8-95, 8-100, 8-102 

Extensions 

definition 

1-12 


Level 1 

1-20 

5-16 


Level 2 

1-23 

5-16 


VT52 emulation 

A-36 


132-Column 

5-16, 

5-18 

Extensions to ReGiS 

8-23, 

8-31, 8-37, 8-95, 8-101, 


8- 

102, 8-103, 8-104, 8-107, 


8- 

118, 8-119, 8-122, 8-132 

External Interface 

6-14 


-F- 

F(B) 

8-138 


F(C) 

8-90 


F( F) 

8-139 


F(P) 

8-90 


F(V) 

8-90 


F(W) 

8-141 


Factory Default State 

definition 

4-7 


Fallback Transmission 

Control Representation Mode 

7-28 


DEC special graphics 

7-20 


DEC supplemental 

7-21 


DEC technical 

7-25 


definition 

7-5 


DRCS 

7-28 


ISO Latin-1 supplemental 

7-23 


NRC 

7-20 


UPS 

7-28 


FF 

5-79 


Figures 

Figure 8-1 

8-16 


Figure 8-10 

8-140 


Figure 8-11 

8-139 

, 8-141 

Figure 8-2 

8-54 


Figure 8-3 

8-60 


Figure 8-4 

8-62 


Figure 8-5 

8-77 


Figure 8-6 

8-108 


Figure 8-7 

8-109 

, 8-110, 8-133 

Figure 8-8 

8-116, 8-117 

Figure 8-9 

8-120 


Fill 

8-102 


definition 

8-12 
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Fill ( Cent. ) 

instruction 

8-138 


Final Character 

APC 

3-29 


control sequence 

3-23 


definition 

3-11 


device control string 

3-28 


escape sequence 

3-22 


OSC 

3-29 


PM 

3-29 


First Load Character 

10-10 


Fixed Space 

definition 

5-12 


Flood 

definition 

8-12 


instruction 

8-138 


Flow Control 

7-6 


user defined keys 

11-5 


Font 

definition 

5-12 

10-5 


Font Buffer 

10-10 


Font Number 

10-10 


Font Rendition 

10-12 


Font Set Size 

10-12 


Foreground 

8-35 


Foreign Codes 

8-37 


Form Feed 

control function 

5-79 


Format Effector 

definition 

5-13 


-G- 

G— Se ts 

3-59 

5-34 


GO 

3-60, 

5-34 

3-65 

G1 

3-60, 

5-34 

3-65 

G2 

3-60, 

5-34 

3-65 

G3 

3-60, 

5-34 

3-65 

GL 

5-34 


GR 

5-34 


GL 

3-14, 

B-8 

3-60, 3-65 

GR 

3-14, 

3-60, 3-65 


B-8 
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GR Graphic Character 



within control function 

3-24 


Graphic Character 

3-16 


code extension techniques 

3-59 


definition 

3-11 



5-13 



6-26 



8-13 


GL 

3-14 


GR 

3-14 


insertion 

5-56 


replacement 

5-56 


within control function 

3-22 


Graphic Rendition 

5-22 


blink 

5-23 


bold 

5-23 


definition 

5-13 


normal 

5-22 


reverse 

5-23 


selection 

5-39 


underscore 

5-23 


Graphic Symbol 



definition 

5-13 


Graphic Text 



definition 

8-13 


Graphics Carriage Return 

9-20 


Graphics Cursor 



definition 

8-13 


Graphics Devices 

8-23, 

8-31 

Graphics Next Line 

9-20 


Graphics Pipeline 

8-22 


definition 

8-13 


Graphics Printing 

7-58 


print region 

7-58 


print screen 

7-58 


Gray Scale 

8-69, 

8-95, 


8- 

107 

definition 

8-13 


Grid 



terminology 

9-6 


Grid Size 



terminology 

9-6 


-H- 



Hard-copy Devices 

8-65, 

8-127 

Hardware Flow Control 

7-8 


High Level Languages 

8-30, 

8-31, 

HLS 

8-99 


defaults 

8-100 



8-103 


8-145 


8-104, 8-106, 



CJJ-UUU / U-J.JM 

VSRM - Master Index 


14-Apr-1989 Page Index-20 

Digital Internal Use Only 


HLS (Cent.) 

definition 
Hold Screen 
Hold Screen Key 
Hold Screen LED 
Hold Screen Mode 
Horizontal Tab 
control function 
VT52 control function 
Horizontal Tabulation 
clearing 
default 

Horizontal Tabulation Set 
control function 
Horizontal/Vertical Position 
control function 
Host Port 
definition 

Host Port Environment Mode 


HT 

HTS 

Hue 

Human Interface 
HVP 

-I- 

ICH 

Identification 

device 

service class 
Identify 

VT52 control function 
Identify Terminal 
control function 
IGNORE 
IL 

Implementation Dependent 
Implied Compose Sequence 
algorithm 
definition 
Implied XOFF Rule 
In Use Table 

Index 

control function 
IND 


8-13 

12-12, 12-13 

6-44, 6-72 

6-30, 6-44, 6-72 

6-44, 6-172 

A- 7 

5-75 

A-30 

5-26 

5-86 

5-26 

5-85 

5- 66 

6- 26 

3-66, 3-67 

6-15, 6-16, 6-19, 6-20, 6 
6-47, 6-172 
5-75 

5- 85 

8-13, 8-99 

6 - 12 
5-66 ' 


5-90 

4-8 

4-8 

A-13 

B-14 

4- 33 

2- 5 

5- 97 

8-32, 8-35 

6- 42, 6-79, 6-80, 6-134, 
6-145 

6-26 

12-13 

3- 15, 3-60, 3-65 
5-34 

5-82 

5-82 


- 22 , 


6-140 
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Initialization 


Initialization and Reset 
Inoperative 
definition 
Input Processing 

Insert Character 
control function 
Insert Line 

control function 
Insert/Replacement Mode 
control function 
Insertion 
character 

Installation Environments 
Integration of Text and 
Graphics 

Intensity Attributes 

Interface 

external 


internal 


Intermediate Character 
control sequence 
definition 

device control string 
escape sequence 
Internal Functions 
end of line 
scroll down 
scroll up 

Internal Interface 
Introducer 
definition 
Invoke 
defaults 
definition 


IRM 

ISO 4873 


4-17 

12-11 

D-5 

4- 35, 4-37 

6-26 

1-10 

6-13 

5- 90 

5-97 

5-19 

5-52 

5-56 

8-143 

B-40 

8-35, 8-81, 8-96, 8-97, 8-98 
8-103, 8-109 

1-11 

3- 9 

4- 6 

5- 8 
1-11 

3- 9 

4- 6 

5- 8 

3-23 

3-11 

3-28 

3-22 

5-30 

5-31 

5- 30 

6- 14 

5-13 

3-60, 3-62 
3-63, 3-68 
3-11 
5-13 
10-5 
5-52 
3-68 
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ISO 8859-1 3-89 

4-50 

6-24 


RAM 

Key 

definition 

Key Definition Strings 
Key Legend 
definition 
Key Position ID 
definition 
Keyboard 

Keyboard Action Mode 
Keyboard Areas 
Keyboard Dialects 
definition 
table 

Keyboard Layouts 
Keyboard Lock 
Keyboard Locking 
Keyboard Map 
logical 
physical 

Keyboard Usage Mode 
data processing 
definition 
typewriter 
Keyboard Versions 

Keyclick 

user defined keys 
with control key 
within compose sequence 
Keyclick Mode 
Keypad Mode 


-L- 

L(A) 

L(E) 

Label Strip 
application 
permanent 
removable 
system 


6-39 

6-26 

11- 5 

6-26 

6-28 

6-26 

6-15 

6-16, 6-38, 6-172 
6-28 
6-9 
6-26 
6-10 
6-9 
6-44 

12- 15 

6-30 

6-28 

6-82 

6-15, 6-28, 6-30, 6-54, 6-172 
6-26 

6-28, 6-30, 6-54, 6-172 
6-9, 6-15, 6-28, 6-30, 6-54, 
6-82 

6-19, 6-39, 6-46, 6-69, 6-70 
11-5 

6-75, 6-76 
6-141 

6-46, 6-172 

6-16, 6-63, 6-65, 6-66, 6-67, 
6-68, 6-172 


8-105, 8-113, 8-117, 8-118, 
8-121, 8-135 
8-113, 8-121, 8-135 

6-25 

6-26, 6-30, 6-35, 6-70 

6-27, 6-70 

6-27 



EL-00070-IN 

14-Apr-1989 

Page 

Index-23 

VSRM - Master Index 

Digital 

Internal 

Use Only 


Landscape Mode 

definition 

8-13 


Last Column Flag 

definition 

D-13 


Layer 

1-8 


code extension 

1-9 


input processing 

1-10 


presentation service class 

1-9 


LEDs 

compose 

6-30, 6-44, 

6-141 

hold screen 

6-30, 6-44, 

6-72 

legends 

6-30, 6-35 


lock 

6-30, 6-44 


wait 

6-30, 6-38, 

6-44 

Legend 

definition 

6-26 


Level 1 

B-11 


keyboard 

6-15 


Level 1 Sixel Devices 

7-60 


Level 2 

B-11 


keyboard 

6-15 


Level 2 Sixel Devices 

7-62 


Levels 

definition 

1-12 


Levels of Abstraction 

B-6 


LF 

5-76 


Lightness 

8-13, 8-99 


Line 

5-16 


definition 

5-13 


rendition 

5-25 


Line Feed 

control function 

5-76 


VT52 control function 

A-31 


Line Pattern 

8-71, 8-122 


definition 

8-13 


Line Rendition 

5-25 


double-height line 

5-45 


double-width line 

5-44 


single-width line 

5-43 


LK201 

6-7, 6-8, 6- 

-9, 6-15, 6-23 

LNM 

5-53 


Load Instruction 

8-21 


Local Controller Mode 

description 

7-12 


Local Function Keys 

6-28, 6-30, 
6-77 

B-16 

6-44, 6-70, 6-72, 

auto repeat 

6-42 


within compose sequence 

6-141 
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Lock Key 

6-44, 6-61, 6-63 

, 6-69, 6-70, 

6-75, 6-77, 6 

-82 

with control key 

6-75 


Lock Key Mode 

6-44, 6-172 


Lock LED 

6-30, 6-44 


Locking Shift 

3-59 


Level 1 

3-61 


Level 2 

3-61 


Locking Shift One 

3-74 


Locking Shift One Right 

3-77 


Locking Shift Three 

3-76 


Locking Shift Three Right 

3-79 


Locking Shift Two 

3-75 


Locking Shift Two Right 

3-78 


Locking Shift Zero 

3-73 


Logical Graphics Device 

8-32, 8-33, 8-34 

, 8-95 

definition 

8-13 


Logical Keyboard Map 

Logical Pixel 

6-30 


definition 

-M- 

10-5 


Macrographs 

8-30, 8-38, 8-39 
8-87, 8-88 

, 8-49, 8-51, 


B-26 

' 

definition 

8-13 


Main Key Array 

Margin 

6-9, 6-28 


definition 

5-13 


MC 

Media Copy 

7-34, 7-35, 7-36 

, 7-39, 7-49 

auto print mode 

7-35 


print line 

7-49 


print screen 

7-39 


printer controller mode 

7-34 


printer to host mode 

7-36 


Modal Options 

Mode 

' 8-48 


reset mode 

2-26 


set mode 

2-24 


Mode Switching 

B-8 


Modem Control 

12-14 


Modes 

5-18 


auto print 

6-73 

7-35 


auto repeat 

6-16, 6-40, 6-41 

, 6-172 

auto wrap 

D-13, D-15 


Cl transmission 

3-67, 3-71, 3-72 
6-172 
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Modes (Cont.) 

caps/shift lock 

6-16, 6-17, 6-77, 

6-78, 6-82, 

character set mode 

6-172 

6-22, 6-52, 6-172 


column 

5-18, 5-47 


compose 

6-172 


conformance level 

6-172 


control representation 

D-16 


cursor key 

6-16, 6-60, 6-62, 

6-172 

default 

5-20 


definition 

5-13 


hold screen 

6-44, 6-172 


host port environment 

3-67 


6-15, 6-16, 6-19, 

6-20, 6-22, 

insert/replacement 

6-47, 6-172 
5-19, 5-52 


keyboard action 

6-16, 6-38, 6-39, 

6-172 

keyboard usage 

6-57 


keyclick 

6-46, 6-172 


keypad 

6-16, 6-63, 6-65, 

6-66, 6-67, 

lock key 

6-68, 6-172 
6-44, 6-172 


national replacement 
character set mode 

6-52 


new line 

5-20, 5-53 



6-16, 6-65, 6-75, 

6-79, 6-172 

numeric keypad mode 

6-172 


origin 

5-19, 5-51 


print extent 

7-38 


print form feed 

7-37 


printer controller 

7-34 


printer port environment 

3-67 


printer to host 

6-172 

7-36 


screen 

5-19, 5-50 


scrolling 

5-18, 5-49 


send/receive 

D-12 


text cursor enable 

5-20, 5-54 


Multinational Mode 

3-7 


Multiplane Displays 

8-35 


Multiplane Writing 

8-133 


-N- 

National Keyboards 

6-12 


National Mode 

3-7, 3-64 


National Replacement 

Character Set (NRCS) 

3-7, 3-64 


extension 

7-18 

6-21, 6-22, 6-81, 

6-183 
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Natural Image 

8-10 


NEL 

5-84 


New Line Mode 

5-20 



6-16, 

6-65, 6-75, 6-79, 6-172 

control function 

5-53 


with control key 

6-79 


Next Line 

control function 

5-84 


Non-Spacing Diacritical Key 

6-12, 

6-26, 6-42, 6-44, 6-80, 


6- 

134, 6-140, 6-145 

definition 

6-25 


Normal Rendition 

5-22 


Number of Characters to 

Overflow 

12-9, 

12-10 

Numeric Arguments 

8-30, 

8-45, 8-67, 8-82 

Numeric Keypad 

6-33 


Numeric Keypad Front Legends 

6-34 


Numeric Keypad Key 

6-28, 

6-62, 6-63, 6-65, 6-66, 


6- 

67, 6-68 

codes generated 

6-64 


within compose sequence 

6-141 


Numeric Keypad Mode 

6-172 


control function 

6-68 


Numeric Parameter 

definition 

3-11 


multiple 

3-25 


-0- 



Offset 

definition 

8-13 


Open Curve Sequence 

definition 

8-13 


Open Extensions 

8-122 

, 8-131, 8-132, 8-134, 


8- 

135, 8-138 

Operating System 

definition 

5-14 


Operating System Command 

(OSC) 

3-28 


introducer 

3-29 


Origin Mode 

5-19 


control function 

5-51 


Overlap 

terminology 

9-7 


Overlay Writing 

definition 

8-13 



P(B) 

8-65, 

8-68, 8-77, 8-90, 8-136 
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P(E) 

8-68, 8-77, 8-90 

P(P) 

8-131 

P(S) 

8-68, 8-77, 8-90 

P(W) 

8-68 

Parameter 

device control string 

3-28 

maximum value 

3-24 

nume r i c 

3-11, 3-25 

private 

3-26 

selective 

3-11, 3-25 

unimplemented 

3-20 

Parameter String 

3-23 

definition 

3-11 

device control string 

3-28 

examples 

3-27 

maximum length 

3-24 

Parameters and Constants 

5-27, 5-28 

Parsing 

3-31 

Pascal 

2-4 

Permanent Label Strip 

6-30, 6-35, 6-70 

definition 

6-26 

Physical Keyboard Map 

6-28 

Picture Element 
definition 

8-14 

Pixel 

8-10, 8-33, 8-34 

definition 

8-14 

terminology 

9-6 

Pixel Aspect Ratio 

8-63 

terminology 

9-6 

Pixel Image 

8-69 

Pixel Sizes 

8-34, 8-55, 8-70 

Pixel Specifiers 

8-80 

Pixel Vectors 

8-46, 8-52, 8-54 

definition 

8-75, 8-76, 8 
8-123, 8-130 
8-14 

Pixel-Spot 

terminology 

9-6 

Plotting Devices 

8-52, 8-95 

PM 

introducer 

3-29 

Portrait Mode 
definition 

8-14 

Position Address 
definition 

8-14 

Position Arguments 

8-43, 8-52, 8-55 

Position Instruction 

8-69, 8-73, 8 
8-88, 8-104, 
8-119, 8-123, 
8-20, 8-67 


Page lndex-27 
Internal Use Only 


, 8-136 
, 8-136 


, 8-95 

, 8-69, 8-73, 
-82, 8-112, 


, 8-58, 8-59, 
-75, 8-77, 8-87, 
8-107, 8-110, 
8-127, 8-138 
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Position Stack 

8-55 


Position Value 

8-68 


Power-Up State 

definition 

4-7 


Presentation Service Class 

1-9 


Primary Device Attributes 

B-13 


definition 

4-7 


Print All Pages 

7-30 


Print Composed Main Display 

7-30 


Print Cursor Line 

VT52 control function 

A-41 


Print Extent Mode 

control function 

7-38 


definition 

7-5 


description 

7-12 


Print Form Feed Mode 

control function 

7-37 


definition 

7-5 


description 

7-12 


Print Line 

7-31 


control function 

7-49 


definition 

7-6 


Print Page 

7-30 


definition 

7-6 


Print Screen 

7-30 


control function 

7-39 


definition 

7-6 


VT52 control function 

A-42 


Print Screen Key 

6-73 


Printer Controller Mode 

B-10 


control function 

7-34 


definition 

7-5 


description 

7-10 


Printer Port 

definition 

6-26 

7-5 


environment 

3-66, 

7-9 

3-67 

Printer Port Environment Mode 

6-172 


Printer Port Extension 

A- 9 


Printer Status 

7-8 


Printer Style 

7-13 


All Characters 

7-15, 

7-16 

National Only 

7-13 


National Plus Line Drawing 

7-14 


Printer To Host Mode 

control function 

7-36 


definition 

7-5 


description 

7-9 


Privacy Message 

3-28 




EL-00070-IN 

14-Apr-1989 

Page 

Index-29 

VSRM - Master Index 

Digital 

Internal 

Use Only 


Private Parameter 

3-26 

Product Certification 

1-26 

Product Class 

■ 

DECmate/WPS 

6-35 

Digital standard 

6-35 

Product Conformance 

1-26 

Program Structure 

2-6 

Programmable Keys 

11-5 

Programmer's Guide 

B-5 

Protocol 


definition 

8-14 

-Q- 


Quoted Strings 

8-29, 8-38, 8-39, 8-43, 8-58, 


8-68, 8-75, 8-83, 8-87, 8-107, 


8-143 

-R- 


R(E) 

8-135 

R(L) 

8-118 

R(M) 

8-87 

R(P(I ) ) 

8-136 

R(P) 

8-88, 8-137 

Raster 


terminology 

9-7 

Raster Device 

8-23, 8-34 

definition 

8-14 

Raster Scan 


definition 

8-14 

Raster Size 


terminology 

9-7 

Rate Limiting 


user defined keys 

11-5 

Receive 


definition 

6-27 

Received Data Stream 


definition 

5-14 

Reference Standards 

4-50 


5-9 


6-23 


8-11 

Referenced Documents 

3-88 

ReGIS 


address space 

B-25 

arguments 

8-21 

character orientation 

B-35 

color map 

B-39 

definition 

8-14 
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ReGIS (Cont.) 
extensions 
hard copy 
initialization 
macrograph 
philosophy 

pixel vector specifiers 

screen area 

scrolling 

synchronization 

syntax 

text command 
wrap 

writing modes 
Relative Location 
definition 

Remote Graphics Devices 
Removable Label Strip 
definition 
Repeat Introducer 
Replace Graphic Character 
VT52 

Replace Writing 
definition 
Replacement 
character 

Report Instruction 
Report UDK Status 
control function 
Required Extensions 
Required Functions 
Level 1 
Level 2 

Reserved Characters 
Reset 

definition 
Reset Mode 
auto print 
auto wrap 
column 

control function 
insert/replacement 
new line 
origin 

print extent 
print form feed 
printer controller 
printer to host 
screen 


B-24 

B-25 

B-20 

B-26 

8-22 

B-38 

B-35 

B-38 

B-18 

8-29, 8-37 
B-17 
B-34 
B-38 
B-21 

8-14 

8- 19 
6-70 

6- 27 

9- 15 

A-12 

8-14 

5-56 

8-21, 8-87, 8-118, 8-135 

11- 7 
8-103 

1-18 

1- 23 

12 - 12 
12-15 
8-14 

7- 35 
D-15 
5-47 

2- 26 
5-52 
5-53 
5-51 
7-38 
7-37 
7-34 
7-36 
5-50 
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Reset Mode (Cont.) 
scrolling 
send/receive 
text cursor enable 
Reset To Initial State 
control function 
Response Time 
to XOFF 

Restore Cursor 
control function 
Return Key 
auto repeat 
with shift key 
within compose sequence 
Reverse Index 

control function 
Reverse Line Feed 

VT52 control function 
Reverse Rendition 
RGB 
RI 
RIS 

Implied XOFF Rule 
RM 

Rotated Print 
sixel 

-s- 

S(A) 


default set 


S(C) 

S(D) 

S(E) 

S(F) 

S(H) 

S(I) 


S(M) 

S(R) 

S(S) 

S(T) 


5-49 

D-12 

5-54 

D-5 

12-10 

5- 71 

6- 75, 6-79 

6-42 

6-77 

6- 141 

5-83 

A-33 

5-23 

8-99 

5-83 

D-5 

12-14 

2-26 

7- 61 

7-59 


8- 

-31, 

8-33 

f 

8-53 

, 8-58, 

8- 


8- 

61, 8 

— 

64, 8 

-69, 8- 

113 


8- 

125, 

8 

-129, 

8-132, 

8- 


8- 

136 





8- 

-64, 

8-68 


8-69 

, 8-71, 

8- 


8- 

104, 

8 

-106, 

8-107, 

8- 


8- 

109, 

8 

-111, 

8-113, 

8- 


8- 

115, 

8 

-116, 

8-121, 

8- 


8- 

124, 

8 

-126, 

8-127, 

8- 


8- 

133, 

8 

-139 



8- 

-124 






8- 

-123 

, 8-124, 8- 

126, 8- 

129 

8- 

-65, 

8-68 

f 

8-111, 8-129, 


8-65 


8-54, 8-66, 8-109, 8-127, 

8-104, 8-105, 8-109, 8-111 
8-128 

8-109, 8-127, 8-128 
8-124, 8-128 
8-124, 8-126, 8-129 
8-106 


59, 

135, 

82, 

108, 

114, 

123, 

130, 


8-132 

8-135 
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S(W) 

S7C1T 

S8C1T 

Saturation 
Save Cursor 

control function 
Scan 

definition 

Scan Terminator Character 
Screen Alignment 
control function 
Screen Instruction 
Screen Mode 

control function 
Screen Setup Command 
Scroll 

definition 
Scroll Down 

internal function 
Scroll Up 

internal function 
Scrolling Data 
Scrolling Mode 
control function 
Scrolling Region 
default value 

Secondary Device Attributes 
definition 
Secure Reset 

control function 
Select 7-Bit Cl Transmission 
control function 
Select 8-Bit Cl Transmission 
control function 
Select Character Attribute 
control function 
Select Conformance Level 


control function 
Select Graphic Rendition 
control function 
Selective Erase In Display 
control function 
Selective Erase In Line 
control function 
Selective Parameter 
definition 


8-130 

3-71 

B-12 

3- 72 
B-12 

8-13, 8-99 

5-69 

10-5 

10-17 

D-18 

8-20, 8-58, 8-104, 

5-19 

5-50 

8-36 

5-14 

5-31 

5-30 

8-122 

5-18 

5-49 

5-18, 5-19, 5-32 

5-32 

B-14 

4- 7 

4- 35 
B-12 
3-71 
B-12 

3- 72 

5- 41 

6- 17, 6-38, 6-70 
B-11, B-14 

D-20 

4- 27 

5- 39 
5-100 
5-94 
3-11 


8-122 
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Selective Parameter (Cent.) 
multiple 

Selectively Erasable 
Characters 
Self-Test 
definition 
Send/Receive Mode 
control function 
Service Class 

character cell display 
definition 
identification 
Session 

definition 

Set Keypad Application Mode 
control function 
Set Keypad Numeric Mode 
control function 
Set Mode 
auto print 
auto wrap 
column 

control function 
insert/replacement 
new line 
origin 

print extent 
print form feed 
printer controller 
printer to host 
screen 
scrolling 
send/receive 
text cursor enable 
Set Raster Attributes 
Horizontal Extent 
Pixel Aspect Ratio 
Vertical Extent 
Set Size 
definition 

Set Top and Bottom Margins 
control function 
Set-Up 

definition 
Set-Up Key 

Set/Reset Auto Repeat Mode 
control function 
Set/Reset Character Set Mode 
control function 
Set/Reset Cursor Key Mode 
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3- 25 

5- 24 
12-15 

4- 7 

D-12 

5- 6 
1-10 
4-8 

7-6 

6 - 66 

6- 67 


7-35 

D-15 

5-47 

2-24 

5-52 

5-53 

5-51 

7-38 

7-37 

7-34 

7-36 

5-50 

5-49 

D-12 

5-54 

9-16 

9-16 

9-16 

9- 16 

10- 5 

5- 32 

6- 27 
6-73 

6-41 

6-52 

6-62 
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Set/Reset Keyboard Action 

Mode 


control function 

6-39 

Set/Reset Keyboard Usage Mode 

control function 

6-57 

Set/Reset National 

Replacement Character Set 

Mode 

6-52 

Seven Bit Encoding 

8-43, 8-121, 8-143 

SGR 

5-39 

Shading 

8-102, 8-109, 8-121, 8-133 

definition 

8-14 

Shift Functions 

3-59 

Shift In 

3-73 

within control function 

3-21 

Shift Key 

6-61, 6-63, 6-69, 6-75, 6-78, 

6-82 

auto repeat 

6-42 

with control key 

6-75, 6-77 

with delete key 

6-77 

with function key 

6-70 

with local function key 

D-20 

with return key 

6-77 

with space bar 

6-77 

with tab key 

6-77 

Shift Lock 

6-16, 6-17, 6-77, 6-78, 6-82, 
6-172 

Shift Out 

3-74 

within control function 

3-21 

Single Shift 

3-59, 3-62, 3-66 

Single Shift Three 

3-81 

Single Shift Two 

3-80 

Single Width Line 

5-25 

control function 

5-43 

Sixel 

8-127 

definition 

8-14 

10-5, 10-17 

terminology 

9-7 

Sixel Active Position 

terminology 

9-7 

Sixel Bit Pattern 

10-17 

Sixel Command 

Format 

9-13 

Sixel Printing 

7-58 

color 

7-59 

compressed 

7-60 

expanded print 

7-59, 7-61 

monochrome 

7-59 

rotated print 

7-59 
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SM 


set mode 

2-24 

Soft Character Sets 

10-6 

Soft Fonts 

10-6 

Soft Terminal Reset 


control function 

4-37 

Software Conformance 

B-6 

auto repeat mode 

6-41 

character font data 

10-17 


11-13 

compose key processing 

D-20 

control representation mode 

D-16 

designating character sets 

3-62 


19 Page 

Digital Internal 


device identification 
device test 
double-height lines 
extensions 
horizontal/vertical 
position 

invoking character sets 
keyboard Usage Mode 
local function keys 
new line mode 
pad characters 
reset to initial state 
screen mode 

terminating control strings 
VT52 emulation 
SPACE 

definition 
Space 
Space Bar 

with shift key 
Special Characters 
10/0 
15/15 

2/0 (space) 

7/15 (delete) 
special characters 
SRM 

State Variables 
Status Report 
definition 
String Delimiter 
definition 
String Terminator 


5-34 

4- 33 
D-11 

5- 25, 5-45 
1-12 

5- 66 
3-62 

6- 57 
D-20 
5-20 
3-17 

D-5, D-8 

5- 19 
3-30 

A-5, A-14, A-15 

6- 27 

3-12, 3-14, 3-17 

6-75, 6-79, 6-'81 

6-77 

12-12 

3-17 

3-17 

3-17 

3-17 

12-11 

D-12 

5-29 


5-14 

3-19, 3-28 
B-10 
5-81 
B-6 


Index-35 
Use Only 


SUB 

Subroutine Library 
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Substitute 

3-19, 3-30 

control function 
Synchronization 

5-81 

keyboard 

12-12 

screen 

12-12 

Synthetic Graphics 

System Label Strip 

8-10 

definition 

-T- 

6-27 

T(A) 

8-65, 8-82, 8-83, 8-105, 8-111, 
8-113, 8-117, 8-126, 8-135 

T(B) 

8-105, 8-114 

T(D) 

8-105, 8-114, 8-115, 8-116 

T(E) 

8-105, 8-114 

T(H) 

8-110, 8-111, 8-114 

T(I) 

8-105, 8-114 

T(M) 

8-53, 8-110, 8-111, 8-115 

T(S) 

8-53, 8-105, 8-110, 8-111, 8-114, 
8-115, 8-116 

T(U) 

8-53, 8-105, 8-110, 8-111, 8-115, 
8-116 ■ 

T(W) 

8-116 

Tab Key 

6-75, 6-80 

with shift key 

6-77 

within compose sequence 

6-141 

Tab Stops 

Tabulation 

A-6, A-7, A-11 

clearing 

5-86 

definition 

5-14 

horizontal 

5-26 

stop 

5-14 

Tabulation Clear 

5-86 

control function 

Tabulation Stops 

5-86 

clearing 

5-86 

default 

5-26 

definition 

5-14 

horizontal 

5-26 

TBC 

5-86 

Temporary Options 

8-48 

Terminal Components 

1-7 

Terminal Initialization 
Terminal Interface 

B-10 

Architecture 

B-5 

Terminal Management 

1-10 

Terminal Management Functions 

4-4 

definition 

4-7 

Terminal Synchronization 

6-72 
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Terminal User 
definition 
Termination 

Cl control codes 
cancel 

control sequence 
control string 
escape 

escape sequence 
substitute 
universal 
Terminology 
Dot 
Grid 

Grid Size . 

Overlap 

Pixel i 

Pixel Aspect Ratio' 
Pixel-Spot . 

Raster 
Raster Size 
Sixel 

Sixel Active Position 
Tertiary Device Attributes 
definition 
Test 

control function 
Text Attributes 

Text Cursor Enable Mode 

control function 
Text Instruction 
Text/Full Cell Fonts 
TIA 

Top Margin 

default value 
Transfer 
definition 
Transformation 
Transmission Control 
definition 
Transmit 
definition 

Transmit Data Rate 
Transmitted Data Stream 
definition 


6-27 

3-19 

3-19 

3-18 

3-28, 3-30 
3-19 
3-18 
3-19 

3- 19 

9-6 

9-6 

9-6 

9-7 

9-6 

9-6 

9-6 

9-7 

9-7 

9-7 

9- 7 

4- 7 
D-11 

8-100, 8-114 
B-8 

5- 20 
B-15 

5-54 

8-21, 8-81, 8-112, 8-119 

10 - 12 
B-5 
5-32 
5-32 

5-15 

3-21 

5-15 

5-15 

6-27 

12-10 

5-15 
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Transportability 


definition 
Type Ahead 

-U- 

UDK 

UDK Lock Control 

status report 3 

Undefined Functions 
Undefined Operations 
Underscore Rendition 
Uniinplemented Functions 
control character 
control sequence 
control string V- 

escape sequence 
Unit-^Cell 

Universal Terminator 
User Convenience Function 
auto repeat 
Keyboard Usage Mode 
'User Defined Keys 
control function 
User Preference Features 
definition 
Level 1 
Level 2 

User Preference Supplemental 
Set 

-V- 

VfB ) 

V(E) 
y( S ) 
v(w)-^ 

Variable Aspect Ratio 
Vector Instruction 
Vertical Tab 

control function 
Video Systems Reference 
Manual 

Viewing Point 
definition 

Viewing Point Attributes 
Virtual Terminal 
definition 


8-22, 8-23, 8-24, 8-26, 8-31, 
8-37, 8-59, 8-68, 8-100, 
8-144, 8-145 
8-14 
B-16 


11-4, 11-9 

11-7 

A-11 

I- 14 

5- 23 

3-20 

3-20 

3-20, 3-30 
3-20 
8-116 
3-19 

6- 41 
6-57 

II- 4 
11-9 

1-14 

1-22 

1-25 

6-172 


8-65, 

8-73, 

8-77, 

8-90, 

8-73, 

8-77, 

8-90, 

8-136 

8-73, 

8-73 

8-77, 

8-90, 

8-136 

7- 62 

8- 20, 

8-73 



5-78 




1-5 




8-14 

8-32, 

1-8 

7-6 

8-35 
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Visual Indicators 

6-44 

VT 

5-78 

VT52 Emulation 

A- 5 

required commands 

A- 9 

VT52 Special Graphics 

A- 9 

-W- 

W(A) 

8-124, 8-132 

W(C) 

8-107, 8-108, 8-111, 8-132, 

8-133 

W( E) 

8-107, 8-108, 8-111, 8-129, 

8-133 

W( F) 

8-105, 8-109 

W(I) 

8-104, 8-109, 8-111, 8-128.JJ 

8-132 

W{L) 

8-95, 8-124, 8-132 

W(M) 

8-64, 8-69, 8-71 

W(N) 

8-104, 8-107, 8-108, 8-liij 

8-133 

W(P(M) ) 

8-71 

W(P) 

8-64, 8-69, 8-111 

W(R) 

8-104, 8-108, 8-111, 8-133:’, 

W(S) 

8-65, 8-94, 8-105, 8-109 , ‘8^111 , 
8-117, 8-124, 8-133 , ' 

W(V) 

8-104, 8-108, 8-111, 8-133 

W(W) 

8-111, 8-133 

Wait LED 

6-30, 6-38, 6-44 

Waiver Panel 


certification 

1-28 

Waivers 


definition 

1-13 

Warning Bell 

control function 

5-73 

Writing 

definition 

8-14 

W r i t i ng- A 1 1 r i bu te s 


Instruction 

8-20, 8-69, 8-81, 8-98, 8-10? > 
8-132 

-X- 

XOFF 


Implied 

12-13 

XOFF point 

12-6, 12-7 

second XOFF point 

12-6 

VTlOO 

12-8 

VT220 

12-8 

XOFF state 

12-5 
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XON point 12-7 

VTIOO 12-a 

■ VT220 12-8 

XON/XOFF .J-FZ 

e - iq - 

with user, defined keys 11-5 


K r.. 

■ |3.2-Column Extension 


' .within control function 

•7 -'hit Characters 

' -'Wijthin control -f unction.. v 

,8 f ht-tv A-r chitecture Extension 
^^|®^hs^|>a.racter Set 
“ control function 
r a c t e r s 


3-17.. 

■5-ia^' 

■S’-lf"' 

3-22, 

3-17 




3-^ 


3-7, 3-64. 
■3-¥7 

.342a*-3^ 

6-21 


3-22, 3-24 
3-7 


X IlUC A— ** \J 

Use Only 
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1 READER- 'comments ■ : | 

I ... I 

I Your comments and suggestlbhs will help Standards and Methods | 


I Control improve their services and dociaments . I 

+ + 


Did you request this dacu^ej^J?'^^^^^ If;;j^so, did it arri-^ within a 

satisfactory period of Please 'comment. 


What are your impressions of- -this document? Consider format, 
organization, completeness^ *' readability ,^'‘andiiHustrationS',. , 


_ __ __ __ __ __ __ __ fold on this line -- -- -- -- -- 

Did you find technical or clerical errors in this document? If so, 
please specify the page number (s) and the error (s) . 


Are the instructions for the update package clear? 

Do you have other suggestions for improving this doc\ament? 


The following information is optional: 

Name Mailstop 

Department c' Node 

Send your comments to JOKUR: : PROJECTS, or foid, staple, and send this 
page through interoffice mail to: 


+ 4 - + 

I % READERS' COMMENTS | 
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I CTS1-2/D4 1 
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